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This MailMerge manual includes a chapter (Chapter 5) 
and references to Conditional Printing. This printing 


feature is currently available only for 8080 systems. 
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© 1. Welcome to MailMerge 


...introducing you to MailMerge... 


WHAT YOU HAVE Your MailMerge package includes this manual and a 
disk that contains a file called MAILMRGE.OVR. 
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WHAT YOU NEED You must use MailMerge with WordStar. Talk to 
your dealer if you need more information about your 
computer, printer, and operating system. If you have 
a working knowledge of WordStar and the necessary 
four files listed below, you can use MailMerge. 
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Check the Program Specification Sheet in Appendix 
A for computer memory requirements. 


¢ WS.COM 
¢ WSMSGS.OVR 
¢ WSOVLY1.OVR 


¢ MAILMRGE.OVR 
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A GUIDE TO THIS MANUAL i) 


The MailMerge manual is made up of five chapters 
which build upon your knowledge of WordStar. You 
will also find information on MailMerge in the 
WordStar Training Guide. This manual is organized 
to present concepts and procedures separately. 
Chapters 1 and 2 describe the concepts of 
MailMerge. Chapter 3 describes all the MailMerge 
commands and the procedures for preparing your 
files. Chapter 4 tells you how to print those files. 
Chapter 5 explains the procedures for conditional 
printing. The Appendices list program specifications, 
error messages, and uses for MailMerge. 


Cartoons will guide you through this reference 


material on MailMerge. The following symbols will 
also help you. . 
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Welcome to MailMerge 


SYMBOLS USED IN THIS MANUAL 


‘Remember’ ‘Caution’ 
N—4A 

aaa ie 

‘Return’ ‘CTRL’ 


the control key 


C4 5 or ws 


‘Refer’ 
Refer to the page listed or the WordStar Reference 
Manual index for more information. 


‘Commands’ 

One of these large command symbols appears 
alongside text that offers the most thorough coverage 
of the command. 


MailMerge 


1-4 


OVERVIEW 


MailMerge is a program that works with WordStar to 
perform special printing tasks. Merging is its secret. 
MailMerge takes information from various locations 
and inserts it into a WordStar document file, 
automatically re-forming paragraphs if the informa- 
tion extends beyond the margins. With WordStar and 
MailMerge working together, you can accomplish 
sophisticated printing tasks. 


Personalized Form Letters: MailMerge will take a 
mailing list from one file and a form letter from 
another to produce individual letters. 


Contracts or Standard Documents: MailMerge can 
change words in a standard document or insert stan- 
dard paragraphs so that you don’t have to retype the 
words and paragraphs each time they’re needed. 


Joining Files: MailMerge will print several files in 
one session to produce one continuous document. 
One file can be put inside of another, a useful 
feature for inserting standard paragraphs. Or one file 
can follow another, as in the chapters of a book. 


Conditional Printing: You can tell MailMerge to 
print a document or a paragraph if certain conditions 
are met. For example, MailMerge can be instructed 
to print letters to only those clients who live within a 
local zip code area. 


MailMerge is a very important member of the 
MicroPro family of products because it links 
WordStar to MicroPro data products. For example, 
MailMerge will take customer information from 
invoice forms made in DataStar and insert it into a 
form letter created in WordStar. MailMerge and 
WordStar are an unbeatable pair that gets stronger 
when they team up with the rest of the MicroPro 
family. 
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© 2. Ideas 


...concepts of the MailMerge 
program... 


HOW MAILMERGE MailMerge moves information for you. More 
WORKS specifically, it can merge, connect, and insert. 


MailMerge is like the switchman at a railway yard. 
As the switchman takes orders from the yardmaster, 
MailMerge takes commands from you. 


When trains come down several tracks in the 
switching yard, the switchman can merge cars from 
one train with cars from another. MailMerge can 
merge information (data) from a mailing list into text 
to create a personalized letter. 


| The Svzitchmani can... 
Jet each train onto the 


track ane at a time 


..or coanect trains 


. or gmnerge cars fram 
end. to end. 


one train to another... 


MailMerge 


The switchman can also connect trains end to end to Oo 
make one long train. Similarly, MailMerge can 

connect chapters end to end to make a book. When 

you give the command to print the first chapter, the 
program automatically prints the others in succession. 

This connecting is called chaining. 


Although the switchman is not able to put one train 
inside another, MailMerge can insert text inside of 
text. For example, you can command the program to 
print the introductory paragraph of a contract, then 
print another file which contains a Table of 
Authorities or references, and then resume printing 
the contract. This inserting is called nesting. 


After you give commands to MailMerge, you press M 
at the WordStar Opening Menu and either print a 
document or produce an output file on a disk. 


DATA The data which MailMerge uses come from three 
sources: 


e Datafiles created by MicroPro’s data and calc pro- oO 
ducts or WordStar in non-document mode. 


e An operator who enters data at the terminal at the 
time of printing. <—» 3-18 


« A command at the top of the document itself. 
—-> 3-22 


DATAFILES A datafile is a group of related pieces of information 
(called records) stored together on a disk. You store 
records in your computer file just as you store them 
in a filing cabinet. A datafile can be a file of invoices 
or a mailing list, e.g., all the names and addresses on 
the Galactica Corporation customer list shown in the 
illustration which follows. 
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DATA RECORDS 


DATA FIELDS 


Ideas 


DATAFILE 


a iN 


DATA FIELD 


DATA RECORD 


CUSTOMER DTA 


1 Dee Skies. 77 Sunset Strip.| “Hollywood. CA 
2. Flash Gordon. Outer Space 
3. Polly Polaris, 664 Etoile Court. ‘Jacksonville, FL” 


A data record contains a set of related information. 
It could be information from a single invoice or from 
a single entry on a mailing list. Dee Skies is a 
customer of the Galactica Corporation. When her 
name and address are entered into a datafile, they 
become a record. Each time a new name and address 
is added to the mailing list, a new record is created. 


A data field is a single item of information on the 


_ Mailing list. Dee Skies’ name, title, address, and zip 


code are entered into data fields. Every record in the 
datafile must have the same number of fields in the 
same order. Fields are identified by number or by 
name. For example, the field which contains Ms. 
Skies’ address could be called the address field or the 
third field. 


NOTE: You can create datafiles by using WordStar 
in non-document mode. This procedure is described 
in Chapter 3 of this document and in the WordStar 
Reference Manual. A better way to create datafiles, 
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however, is to use MicroPro’s DataStar program. Oo 
With DataStar you design a form, such as an 

invoice, then fill in the blanks. The data you enter 

into the blanks (or ‘‘data fields’’) are stored on disk 

as a datafile. Each completed form is a separate 

record. DataStar automatically puts the required 

commas and carriage returns in the proper place so 

that MailMerge can ‘‘read’’ the file (see Chapter 3). 


VARIABLE DATA _ Variable data is information that changes from 
document to document. If you use the proper 
commands, MailMerge will merge data into text 
automatically and continuously to produce 
personalized letters. The text remains the same, but 
the data, such as the specific information in the 
address field of a data record, change with each 


copy. 
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MASTER A master document, sometimes called a matrix 

DOCUMENT document, provides the text into which you merge 
data. The text in a master document remains the 
same each time you print; it could be the body of a 
form letter or a contract, for example. 
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DOT COMMANDS 


Ideas 


A master document is like a form to be filled in. 
When given the appropriate command, MailMerge 
puts data into the proper places. In everyday 
language, the command tells MailMerge, ‘‘Find the 
variable data for address or phone or name and put 
them in the text at the indicated place.’’ In the place 
where you want variable data inserted, you put 
special names, called generic names. You enclose the 
generic names in ampersands (&). MailMerge 
recognizes the ampersands and the generic names and 
replaces the generic names with the variable data. 
Chapter 3 includes a large illustration of a master 
document. ——> 3-2 


A master document is a document file that contains 
the following: 


¢ dot commands ——3.WS 
* text 
© generic names @—> 3-8 


NOTE: Sometimes you put only dot commands in a 
document file. This file, called a command file, is 
discussed later in this chapter. A command file and a 
master document are not distinct types of files. They 
are just different names given to WordStar document 
files. 


When you use WordStar, you indicate how you want 
the printed page to look by putting dot commands in 
your document file. 


A dot command begins with a period (dot) typed in 
the first column of a WordStar file. The dot is 
followed by two characters. The two characters are 
sometimes followed by a space and more characters. 
A dot command must always end with a hard 
carriage return. 


MailMerge obeys WordStar dot commands as well as 
its own. In MailMerge, dot commands control not 
only merging, but also other aspects of the printing 
process. 
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The following MailMerge dot commands will be a) 
explained in Chapter 3. 


Commands for merging data: 


-DF Define File p. 3-13: 

-RV Read Variables p. 3-14 

-AV Ask (for) Variables p. 3-18 

SV Set Variables p. 3-22 
Command for inserting files: 

.FI File Insert p. 3-24 
Command for multiple copies: 

-RP Repeat p. 3-26 


Commands for re-forming text at printing time: 


-PF Print Time Line Forming p. 3-29 
-.OJ Output Justification p. 3-31 
IJ Input Justification p. 3-32 


Commands for screen displays: 


-DM Display Message p. 3-32 
-CS Clear Screen p. 3-34 


Commands for conditional printing: 


-EX Conditional Command p. 5-4 
(‘Except when this is so...’’) 


.IF Conditional Command p. 5-4 
(“If this is so...’’) 


-EF End Command p. 5-6 
(‘Resume printing here when 
condition is true’’) 


A generic name, sometimes called a variable name or 
variable reference, is a name for variables. It is a 
general term that describes a set of similar data. For 
example, the many different towns on a mailing list 
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© might be grouped under the generic name ‘‘City’’ or 
“Town.’’ (You can choose whatever generic name 
you like.) You can also use symbols and abbrevia- 
lions as generic names. MailMerge recognizes a 
generic name for variables in the text when amper- 
sands (&) enclose the name. 


as Rae qf} ho yan 
7 AL NM 
M7 ~ 


Some examples follow: 
If variable data were 

Milan, Paris, Tokyo, New York 
the generic name might be 


&CITYE& or &City& or ETOWNE or 
&ADDRESS2& 


If variable data were 
94114, 94116, 89997 
the generic name might be 


oO &ZIPCODEE or &Zip-Code& or &ZIP& 


MailMerge 


CHAIN PRINTING Chain printing is the printing of one file after i) 


NESTED 
PRINTING 
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another. By putting a dot command that names 
another file at the end of a file, you command 
MailMerge to print the other file automatically. 
There is no limit to the number of files which can 
be printed in a chain. 


Even files from different disks can be chained 
together. MailMerge accepts a command requesting 
an operator to change a disk during printing. 


Nested printing is the printing one file inside 
another. You can put a dot command in a file where 
you want another file to be inserted. Then you 
command MailMerge to print the file which is named 
in the dot command before continuing to print the 
original file. For example, a campaign letter might 
have standard opening and closing paragraphs. 
Intervening paragraphs, however, might be written 
only for particular constituencies. Those intervening 


* 


Ideas 


Oo paragraphs could be ‘‘nested’’ inside the campaign 
letter with a MailMerge dot command. You can also 
nest a file within a file which is itself nested. In this 
case, nesting is limited to a maximum of seven levels. 


COMMAND FILES A command file is a document file that contains 
mostly dot commands. A command file is like a 
recipe for printing with MailMerge. You put all of 
your MailMerge and WordStar dot commands into 
one file and then print that file with M at the 
Opening Menu. For example, by creating a command 
file, you can chain print all the chapters of a book 
without opening and editing each of the files which 
contain those chapters. Or you can print envelopes 
and letters in one printing session by putting the 
appropriate commands in a command file. 


3. Preparation 


...preparing documents for 
MailMerge...using the program’s 
dot commands... 


GETTING 
STARTED 


BASIC ACTIONS 


Many of the actions you take to prepare documents 
for MailMerge seem complex the first time you try 
them, but they soon become second nature. This 
chapter describes those actions in step by step 
procedures. Sometimes not all of the steps are 
explained under the heading for a procedure, but 
arrows will indicate where information can be found 
on subsequent pages. For example, all the steps for 
creating a master document start on page 14, but 
arrows indicate that more information on the dot 
commands used in a master document can be found 
elsewhere in the chapter. Before you learn to prepare 
documents, you must read Chapters 1 and 2 and 
know how to use WordStar. 


MailMerge only works with WordStar. 
Before you begin, make a copy of the MailMerge 
program file and store the original in a safe place. 


Ask your dealer for help or refer to your operating 
system manual. 


To prepare to use MailMerge, you must take these 
basic actions: 


e Make sure your computer is logged on to the drive 
which contains the MailMerge disk. 


e Put dot commands in a WordStar document file. 
© Supply variable data for merging. You may supply 


data by creating a datafile and giving MailMerge a 
command to ‘‘read variables’’ from that file. You 
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may also enter data through the keyboard at the 
time you are printing, a process called ‘‘asking for 
variables.’’ And finally, you may put data in a dot 
command in the master document, a process called 
“setting variables.”’ 


NOTE: If you are chaining or nesting, you do not 
need to supply variable data for merging. 


A MASTER DOCUMENT 


Before you can merge data into text, you must create 
a master document. This section presents the pro- 
cedure for creating a simple master document. The 
arrows tell you where to find more information 
about the dot commands you can use. An illustration 
of a master document follows: 


OP 

.DF CUSTOMER.DTA 

.RV N,NAME,TITLE,STREET,LOCALE,ZiP,PRODUCT 
-SV DATE, August 30, 1982 

.AV SIGNATURE 


&DATE& 
&NAME& 
&TITLE/O& 
&STREET/O& 
&LOCALE& &ZIP& 


Dear Stargazer, 


Congratulations! Your purchase of &Product& is your introduction to an all-star 


attraction, the MicroPro family of software We know you and your neighbors in 
&Locale& will be pleased with &Product& and will want to meet the other members 
of this stellar family. 

So keep in touch with your dealer for upcoming ‘‘star’’ altractions. 


Sincerely, 


&Signature& 
MicroPro International 
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HOW TO CREATE 
A MASTER 
DOCUMENT 


Preparation 


A dot command must always begin in the first 
column of a document file, may be no longer than 
240 characters, and must end in a carriage return. 
Dot commands may be typed in upper or lowercase 


letters. 


Follow these STEPS to create a master document: 


STEP 1 
STEP 2 


STEP 3 


STEP 4 


STEP 5 


STEP 6 


STEP 7 


STEP 8 


STEP 9 


Start WordStar. 
Open a document file. WS 


Enter the WordStar dot commands that 
affect page numbering. (.OP or .PN) 


(OPTIONAL) Enter the WordStar dot 
commands to design the printed page (for 
example, .PL, .MB.). 


(OPTIONAL) Enter the MailMerge dot 
commands for screen display. (.DM) (.CS) 
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When data are stored in a datafile, enter 
the MailMerge dot command followed by 
the name of a datafile. (.DF) ——> 3-13 


Enter other WordStar dot commands if 
desired. 


Enter the MailMerge dot commands to 
supply variable data. (.RV) ——> 3-14 
(AV) —> 3-18 (SV) ——> 3-22 


Type the text and enclose generic names in 
ampersands (&) where you want 
MailMerge to insert variable data. Do not 
add extra spaces. MailMerge will justify 
text when it prints and margins will be 
aligned. 


If a record in a datafile has an empty 
field, type a slash and the letter O (/O) 
immediately after the generic name but 


MailMerge 


before the closing ampersand. Unless you a) 
insert /O, MailMerge will leave a blank 

space in your text where it finds no 

variable data. 3-10 


NOTE: /O will only work when the 
generic name that it follows is on a line by 
itself. Do not use /O after a generic name 
within text. 


STEP 10 Enter the WordStar dot command for 
page breaks. (.PA) 


STEP 11 Save the file. 


If you complete these steps and have given data to 
MailMerge, you are ready to print. 


A SAMPLE The illustrations on the following pages show 
MASTER examples of a datafile, a master document, the screen 
DOCUMENT at printing time, and some of the letters that would 

be produced if the master document were printed 

with MailMerge. The sample uses all three of the oO 


commands which supply data for merging (.AV, .SV, 
-RV). Comments tell you what the dot commands 


mean. 
Here is the datafile: 
ist field = a number (N) 4th field = STREET 7th field = PRODUCT 
2nd field = NAME Sth field = LOCALE A carriage return (<) ends 
3rd field = TITLE 6th field = ZIP fach;tecords 


Vee N foal 
B:CUSXOMER DTA 


1,Dee Skies,Astrologer,77 Sunset Strip,""Hollywood, CA" ,90025,WordStar < 
2,Flash Gordon, ,99 Nova Avenue, ‘Dallas, TX"',75231,InfoStar < 
3,Patrick Pollux, 33 Galaxy Circle,“"Century City, CA”,90068,InfoStar < 
4,Sky King,Rancher, ,"'Missoula. **.§9802,WordStar < 
5,Polly Polaris, SpaceC) Court,“Jacksonville, FL" .33152,WordStar < 


ach full line is a record ometimes fields are When the data in a field 
containing 7 fields. empty, but commas hold include a comma, quotes 
the place. surround the field. 


oO 
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Preparation 


ey Here is the master document: 


“Omit page numbers.”* “Set the date automatically 
for each letter at 
August 30, 1982."" 


“Find the datafile called 
CUSTOMER.DTA.”” 


“Read the variable data in 
the datafile for all these 
fields.” 


cone |----1----1-----R 


.OP 

OF CUSTOMER DTA 
-RV N,NAME.TITLE,STREET YOCALE,ZIP,PRODUCT 
SV DATE, August 30, 1982 

.AV SIGNATURE 


&DATER 
&NAMEE “Ask the operator to enter 


Tr : : 
SSTRELTIOR 4 Signature at printing 


&LOCALES& &ZIP& lime,”” 


Dear Stargazer, 


Congratulations! YouNourchase of &Product& is your introduction to an ali-star 
altraction, the MicroPrcXamily of software. We know you and your neighbors in 
&Locale& will be pleased \ith &Product& and will want to meet the other members 
of this stellar family. 


So keep in touch with your deter jor upcoming '‘star" attractions. 


Sincerely, 


&Signature& 
MicroPro International 
PA 


‘Begin a new page ‘Insert data here and in 

here.”’ the body of each letter. If 
there is no title or street, 
don’t leave a blank line.” 
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Here is the screen at printing time: 


MailMerge printing B:letter not editing 


The .AV command puts 
this request on the screen. 
MailMerge won’t print 
until the operator enters a SIGNATURE? Jay Salesman RETURN 
response. SIGNATURE? Jay RETURN 


SIGNATURE? Jay 


P = Stop PRINT 


Here are the first two letters: 


August 30, 1982 


Dee Skies 
Astrologer 

77 Sunset Strip 
Hollywood, CA 90025 


Dear Stargazer, 


Congratulations! Your purchase of WordStar is your introduction to an all-star at- 
traction, the MicroPro family of software. We know you and your neighbors in 
Hollywood, CA will be pleased with WordStar and will want to meet the other 
members of this stellar family. 


So keep in touch with your dealer for upcoming “‘star’’ attractions. 


Sincerely, 
August 30, 1982 


Flash Gordon 
99 Nova Avenue 
Dallas, TX 75231 


Jay Salesman 
MicroPro International 


Dear Stargazer, 


Congratulations! Your purchase of InfoStar is your introduction to an all-star at- 
traction, the MicroPro family of software. We know you and your neighbors in 
Dallas, TX will be pleased with InfoStar and will want to meet the other members 
of this stellar family. 


So keep in touch with your dealer for upcoming ‘“‘star"’ attractions. 


Sincerely, 


Jay 
MicroPro International 


Preparation 


Here are the other letters: 


August 30, 1982 


Patrick Potlux 
33 Galaxy Circle 
Century City, CA 90068 


Dear Stargazer, 


Congratulations! Your purchase of InfoStar is your introduction to an all-star al- 
traction, the MicroPro. fanyly of soliware: We know yous and f yout neighbors in 
Century City. 

members of t 


Sky King 
Rancher 
Missoula, MT 59802 


So keep in to 


Sincerely, 


Dear Stargazer, 


Jay Salesmar 


Congratulations! Your purchase of WordStar is your introduction to an all-stae at- 
MicroPro Inte B 


traction, the MicroPro ouemils of software. We know you and avout ree in 
Missoula, MT poem ane a z 
members of tt¥ 


August 30, 1982 


Polly Polaris 

Space Caseworker 
664 Etoile Ct 
Jacksonville, FL 32213 


So keep in top 


Sincerely, 


Dear Stargazer, 


Jay Salesmanf 
MicroPro Inter 


Congratulations! Your purchase of WordStar is your introduction to an ali-star at- 
traction, the MicroPro tamily of software We know you and your neighbors in 
Jacksonville, FL will be pleased with WordStar and will want to meet the other 
members of this stellar family. 


So keep in touch with your dealer for upcoming ‘‘star"’ attractions 


Sincerely, 


Jay Saiesman 
MicroPro International 
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USING GENERIC A generic name is a general term that describes a set i) 

NAMES IN THE of similar data. 

MASTER 

DOCUMENT You use generic names in two places in the master 
document: 


e In the commands to supply variable data (.RV, 
.AV, .SV). Notice that the generic names are not 
enclosed in ampersands when used in these 
commands. 


e In the text wherever you want MailMerge to insert 
data. Here the generic names are enclosed in 
ampersands. 


When you use generic names in the text, you always 
surround them with ampersands (&). Then 
MailMerge knows that it must fill that place with 
variable data. A .RV command contains generic 
names for all the fields in a datafile. But you do not 
need to use all of these generic names in your text. 
Put generic names only where you want data. 


An example of generic names chosen to match the Oo 
fields of a datafile follows: 


A:EMPLOYEE LST 


201,Davis,Jeffray,""August 2, 1982",''17,000" 


202,Bloom,Molly,““January 15, 1980"',"°45,000" 
203,Ying,April,"March 4, 1981"',"'28,000" 


These fields might be given the generic names N (for 
number), LAST (for last name), FIRST (for first 
name), DATE (for date), and AMT (for salary). 
They would then be used in a master document. In 
the following illustration, notice that even though the 
date is a field in the datafile and the generic name 
DATE is in the .RV command, &DATE& is not used 
in the text. 


B:PERSONEL.REC 


DF EMPLOYEE.LST 
-RV N,LAST, FIRST, OATE,AMT 


NUMBER; &N& NAME: &LAST&, &FIRST& 
SALARY: &AMT& 


.PA 


Preparation 


NOTE: The order of generic names in the command 
-RV is the same as the order of the fields in the 
datafile. 


The following is an example of a datafile and the 
corresponding generic names in a master document. 
The master document uses dot commands which 
“‘read,’’ ‘‘ask for,’’ and ‘‘set’’ variable data at 
printing time. 


ORDER.DTA 
Business Electronics,1700 Filth Ave , ‘New York, NY"',10011,Mr. Smith,Gizmos 
Computer Devices,1455 Van Ness,"'San Francisco, CA".94926,Ms_ Jones,Whatizits 


DF ORDER OTA 

RV NAME,ADOR1 ADDR2,ZIP,BUYER,PRODUCT 
AV QUANTITY 

SV MONTH.JANUARY 


&MONTH& 


BILL TO: &BNAME& SHIP TO: &BNAME& 
&ADORI& &ADDR1& 
&ADDR2& &ZIP& &ADDR2E& &ZIP& 

ATTN &BUYER& Balance Due 

S&QUANTITY& &PRODUCT& 


At printing time, the screen would look like this: 


After the operator typed a response to the prompt, 
an order would be printed. Variable data from the 
datafile would fill the spaces held by £&NAME&, 
&ADDRI&, LADDR2&, &ZIP&, &KBUYER&, and 
&PRODUCT&. The generic name £MONTH& would 
be replaced by January, and the operator’s response 
would fill the space held by %QUANTITY&. 
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Sometimes you may not have data in a field ina 
record. For example, the following datafile has no 
data in the third field of the second record. The 
empty field is indicated by the two commas after the 
name ‘‘Flash Gordon.”’ This field might be 
represented in the text of a master document as 
&TITLE&. 


1,Dee Skies,Astrologer,77 Sunset Strip,""Hollywood, CA",90025,WordStar 


2,Flash Gordon,,99 Nova Avenue,"'Dallas, TX",75231,DataStar 


To prevent MailMerge from inserting a blank space 
into the text where &TITLE& appears, you add 
“*/Q”? (slash, capital O) after the generic name and 
before the closing ampersand. The generic name 
would then look like this: 


&TITLE/O& 


“The master document would contain the following ) 


generic names in a salutation: 


&NAME& 
&TITLE/O& 


&ADDRE 
&CITY-STATE& &ZIP& 


The following would be the printed results for both 
records: 


Dee Skies 

Astrologer 

77 Sunset Strip 
Hollywood, CA 90025 


Flash Gordon 
99 Nova Avenue 
Dallas, TX 75231 


oO 


RULES FOR 
GENERIC NAMES 


Preparation 


e Use one to forty letters in upper or lowercase and 
digits or hyphens. Do not use any other 
characters. 


¢ Do not use a digit or a hyphen as the first 
character. 


e Select generic names for each field in a record in a 
datafile and, if using a .RV command, list them in 
the same order they appear in each record. 


° You do not need to use all the generic names in 
the text of the master document. 


© Surround generic names with ampersands in the 
text of a master document. MailMerge wili not 
print the ampersands. 


NOTE: MailMerge will print ampersands that do not 
enclose generic names. 


e Do not surround generic names with ampersands 
in .RV, .SV, or .AV commands. 


DOT COMMANDS FOR MERGING 
DATA 


HOW TO GIVE 
DATA TO 
MAILMERGE 


You use dot commands to merge data into text. 
These commands are put at the top of a master 
document in column one. The order of the 
commands is not important except when you use the 
dot commands .DF and .RV to merge data. (The 
.DF command always precedes the .RV command.) 
Furthermore, the number and combinations of dot 
commands you may use are not limited unless you 
are using the command which defines a datafile. 


There are three methods and four dot commands 
to put variable data into a document: 


e Read Variables (.RV) from a datafile (.DF). This 


combination of dot commands makes MailMerge 
print documents repeatedly until all the data 
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available from the datafile have been inserted. The ) 
two commands must be used together. Without the 

-DF command which names the datafile to be used 

as a source, the command to read variables is 

meaningless. MailMerge must have something to 

‘“‘read.’’ And without the command to read 

variables, MailMerge will find the datafile but will 

not know what to do with it. 


DF CUSTOMER.DTA 
-RV N.NAME, TITLE,STREET,LOCALE,ZIP,PRODUCT 


&NAME& 
&TITLE/O& 
&STREETIO& 
&LOCALES &ZIP& 


AM ANAM A As &PRODUCTE, 
AAA &PRODUCTE pnw AVL 


ADM an nnn Ah ALLL, 


e Ask (for) Variables (.AV). This command asks the 
operator to enter information every time it is 
needed in a document. The dot command which 
requests variable data is put in the master 
document, and, at printing time, the request 
appears on the screen. Printing pauses until an 
Operator enters information to be merged into the 
text being printed. 


.AV SIGNATURE 


&SIGNATURES& 
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e Set Variables (.SV). This command sets the 
variable data within a document every time the 
generic name enclosed in ampersands is 
encountered in the text. This dot command, which 
includes both a gencric name and variable data, is 
put at the top of the master document. 


SV DATE, August 30, 1982 


&DATE& 


Define File. .DF followed by a file name identifies a 
file which will supply variable data. .DF followed by 
a file name and the word ‘“‘CHANGE”’ tells 
MailMerge to instruct the operator to change a disk 
for the named file. .DF does not work alone; it 
works with .RV. Together, .DF and .RV cause 
MailMerge to print the master document until all the 
variable data requested have been inserted. The .DF 
command always precedes the .RVY command because 
MailMerge must ‘‘see’’ a file before it can ‘‘read’’ 
the variables in that file. 


Here are some examples of .DF commands which 
could be put at the top of a master document in 
column one before any .RV command appears: 

.DF MAILIST.DTA 

.DF B:CUSTOM.DTA 

.DF NAMES.DTA CHANGE 
NOTE: If you type the word CHANGE after the file 
named in a .DF command, you will see a message on 
the screen when you print. If you have made a 


mistake, an error message will appear, but the file 
will continue printing. 


***Cannot change disk in drive D:, request ignored. 


See Appendix B for details. 


If you have not made a mistake, you will see: 


Insert diskette with file (name of your file); then press RETURN 
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HOW TO WRITE Follow these STEPS to write a .DF command: a) 
A .DF COMMAND 
STEP 1 Starting in column one 
TYPE .DF 
STEP 2 PRESS SPACE 
STEP 3 TYPE filename 
STEP 4 (OPTIONAL) 
PRESS SPACE 


TYPE CHANGE 


as 
JLaerune | 


RULES FOR .DF e Always put .DF above .RV and above text. 


e Do not use more than one .DF in a master 


document. ) 


e Always enter a valid file name for a datafile. 


datafile named in a preceding .DF command. The 
generic names that follow .RV name all the fields of 
the datafile. For instance, if the datafile contains 
specific account numbers, names, and street 
addresses, the .RV command would contain generic 
names for number, name, and address. 


firefly) Read Variables. .RV tells MailMerge to look at the 


NOTE: The order of the specific information in the 
datafile must be the same as the order of the generic 
names in the .RV command. Also, all fields in a 
datafile must be named in the .RV command, even if 
they will not all be used in the text. 


With .DF and .RV in a master document, MailMerge 


reads all the fields and recognizes generic names 
which are enclosed in ampersands (&) in the text. 


*) 
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Then it replaces them with the information you want 
from the datafile. In other words, MailMerge does 
the picking and choosing for you. It reads all the 
variables but only selects the ones you have asked for 
in the text. 


Using .DF and .RV to merge variable data into text 
is the easiest way to produce personalized letters 
from a mailing list. 


The following illustration is a simple example of this 
use of .DF and .RV: 


NAMES DTA 
i, Sam. Main St, Detroit 
2, Joe, Broadway, Richmond 


LETTER TXT 

Raaxa lemons loess 

DF NAMES OT, 

Av N. NAME, STREET CITY 
Dear &NAME&, 

How are things in &CITY&? 
PA 


Dear Sam, 
How are things in Detroit? 


Dear Joe, 
How are things in Richmond? 
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HOW TO WRITE Follow these STEPS to write a .RV cmmand: i) 
A .RV COMMAND 
STEP 1 Starting in column one 
TYPE .RV 
STEP 2. PRESS SPACE 


STEP 3. TYPE generic names for all the fields in 
your datafile. Separate them with commas. 


[Laeronn 
The following example shows you a .RV command in 
two proper forms. The first command uses a comma 


and a space to separate the generic names. The 
second uses only commas. 


RV N, Name, Street, City 
-RV N.Name,Street,City ae) 


RULES FOR .RV e Never use ampersands around generic names. 
* Never put .RV before .DF. 


e You may put other dot commands between .RV 
and .DF. 


¢ .RV must come before any text which is to be 
merged with data read by the .RV. 


e Always provide generic names for all the fields in 
a datafile even though you may not want to use 
all of them. 


e A generic name may be no longer than 40 
characters. 


e A .RV command may be no longer than 240 
characters. 


* 
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e The list of generic names may be too long for one 
line of your screen. If you do not want to use the 
horizontal scroll feature of WordStar, use as many 
-RV commands as necessary to read the variables 
from one datafile. 


The following example illustrates the preceding rule: 


NAMES.DTA 
1. Queen Elizabeth Ul, Buckingham Palace, Westminster, England 


LETTER. TXT 


Lncenleceelonse lene facce | eneclecceleese| aces] eene lence cee ereeleneeeh 


-DF NAMES.DTA 
.RV RECORD-NUMBER, ROYAL-TITLE. PALATIAL-ESTATE 
RV CAPITALCITY, COUNTRY 


Never vary the order of the fields from the order 
followed in the datafile when you list the generic 
names after the .RV. If you do, MailMerge will 
insert data into the wrong places in your text. 


For example, if a datafile looked like this: 


Luis Sweeney, 66 Paim, “Lodi, CA", 95240 


The .RV command must look like this: 


.RV NAME, ADDR1, ADDR2, ZIP 


not like this: 


-RV ZIP, ADDR2, ADDR1, NAME 
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Ask (for) Variables. .AVY commands MailMerge to i) 
ask for variable data at printing time. If a .AV 

command is put into a master document, a prompt 

appears on the screen at printing time, and the 

printer pauses. Printing will not resume until an 

operator enters information. The .AVY command 

contains a generic name. If MailMerge finds the same 
generic name enclosed in ampersands in the text, the 
information which the operator types will be inserted 

into the text. 


The following illustration shows you how .AV 
commands work. 


gr 


f COREG 
ee Dete, DATE |ew BZ Wl , 


NOTE: If you use only .AV commands to merge 
data, you will print one document at a time. After a 
document is printed you must start MailMerge again 
from the WordStar Opening Menu. 


If however, .DF and .RV commands are used in the 
same master document, the request for variables will 
appear on the screen each time MailMerge reads a 
new record in the datafile. MailMerge will ask for 
variables until all the data from the datafile have 
been merged into the text. 


You can. write a simple .AV command with just a 
generic name. If you do, the generic name and a 
question mark appear on the screen at printing time. 
Look at the following example: 


Preparation 


AV PHONENUMBER 


This command in the master document will produce 
this prompt on the screen at printing time: 


P= Stop PRINT 


PHONENUMBER? 


| 


(Re feeeies 


You can also write more complex .AV commands. If 
you add a comma and a digit, you can limit the 
number of characters an operator can type in 
response to the question on the screen. The cursor 
stops after the operator types the maximum number 
of characters. 


This feature is a safeguard against mistakes. In the 
following example, the number would prevent the 
operator from entering more than five characters for 
a zip code: 
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This command in the master document will produce ) 


this prompt on the screen: 


P= Stop PRINT 


ZIPCODE? 


If the operator typed 654321, the screen would show 
this prompt: 


( ziPcope? 65422 


You can create a .AV command that will display a 
message aS a prompt on the screen rather than just 
the generic name. The prompt is enclosed in quota- 
tion marks and is typed before the generic name in 
the .AV command. This feature is helpful when you 
want to give clear instructions to the operator who 
will enter data. A .AV command with a message 
prompt still requires a response from an operator 
before MailMerge will print or output to a file. 
Although the generic name is not seen on the screen, 
it is written in the .AV command after the comment. 
The operator’s response will be inserted into the text 
at the place where the generic name is enclosed in 
ampersands. 


LAV “CITY, STATE?” ADDR2 


*) 


Preparation 


This command in the master document will produce 
the following prompt on the screen at printing time: 


This command in the master document will produce 
the following prompt on the screen at printing time: 


Enter name as. Last. First’ 
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HOW TO WRITE Follow these STEPS to write a .AV command: ) 
A .AV COMMAND 
STEP 1 Starting in column one 
TYPE .AV 
STEP 2. PRESS SPACE 
STEP 3. TYPE one generic name 
OR 


TYPE a prompt enclosed in single or 
double quotation marks 


AND 
TYPE a comma and one generic name 
STEP 4 (OPTIONAL) 


TYPE a comma and a digit 


oO 


RULES FOR .AV © Do not use ampersands around variable names. 


e A line beginning with .AV may be no longer than 
240 characters. 


e¢ A generic name may be no longer than 40 
characters. 


¢ You may use any number of .AV commands. 


¢ You may use .AV commands anywhere in a file. 


——_ a4 Set Variables. .SV tells MailMerge to insert variable 

} } Tv] data throughout the master document wherever the 
generic name appears enclosed in ampersands. The 
-SV command includes the information in the master 
document. MailMerge neither goes to a datafile nor 
asks the operator for data, but simply looks at the 
command itself. 


* 


HOW TO WRITE 
A .SV COMMAND 


Preparation 


The .SV command includes both the generic name 
for variable data and the information that will be 
substituted for the generic name. .SV is very useful 
when a piece of information appears many times in a 
document, because one edit will change every 
oecurrence. 


The following example shows you a use of .SV: 


f SV PARTY}, Fred Falcon 


H SV PAATY2, Ene Eagle 
f This contract 1s between 
\ &PARTY#& and &PARTY2& 


This contract 1s between 
Fred Falcon and Enc Eagle 


Follow these STEPS to write a .SV command: 
STEP 1 Starting in column one 

TYPE .SV 
STEP 2. PRESS SPACE 
STEP 3. TYPE one generic name and a comma 
STEP 4 PRESS SPACE 


STEP 5 TYPE variable data 
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RULES FOR .SV 


¢ Do not use ampersands around generic names. 


e A .SV command may be no longer than 240 
characters. 


e A generic name may be no longer than 40 
characters. 


e You may use as many .SV commands as you like. 


e .SV commands can appear anywhere in the master 
document. 


DOT COMMAND FOR INSERTING 
FILES 
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File Insert. .FI commands MailMerge to insert a 
named file where the .FI appears, either at the end of 
a file or in the middle of text. When MailMerge joins 
one file to the end of another and you print, the 
results are called ‘‘chain printing.’? When MailMerge 
inserts one file inside of another, and you print, the 
results are called ‘‘nested printing.’’ If you insert one 
file inside another, MailMerge will obey all the dot 
commands in the inserted file before returning to the 
original file. 


If you want MailMerge to pause so you can change a 
disk, type the word CHANGE at the end of a .FI 
command. 


The following examples show you .FI commands. 
Chapter 4 gives more sample uses of .FI. 


-FI MAILLIST.DTA 
.FI STANDARD.TXT 
.FI B:;COVER.LTR 


.FI HEADING CHANGE 


* 


o 


HOW TO WRITE 
A .FI COMMAND 


Preparation 


NOTE: If you type the word CHANGE after the file 
named in a .FI command, you will see a message on 
the screen when you print. If you have made a 
mistake, an error message will appear: 


***Cannot change disk in drive D:, request ignored. 


See Appendix B for details. 


If you have not made a mistake, you will see: 


Insert disketle with file (name of your file), then press RETURN 


Follow these STEPS to write a .FI command: 


STEP 1 Move the cursor to the desired location in 
the file 


STEP 2 Starting in column one 
TYPE .FI 
PRESS SPACE 
STEP 3. TYPE the letter of the disk drive and a 
colon (:) if file to be inserted is not on the 
logged disk drive 
STEP 4 TYPE file name of the file to be inserted 
STEP 5 PRESS SPACE 


TYPE CHANGE if file is on another disk 


—_—" 
| 
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RULES FOR .FI 


e There is no limit to the number of .FI commands © 
which can be used in sequence for chaining files. 


e No more than seven files can be inserted inside 


one another with .FI commands. 


DOT COMMAND FOR MULTIPLE 
COPIES 


HOW TO WRITE 
A .RP COMMAND 
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Repeat Until the End of Datafile is Reached. .RP 
commands MailMerge to repeat the printing of a file 
if that file uses a datafile to supply variable data for 
merging. 


There are two uses for .RP: 


¢ You can use .RP for repeated printing. You insert 
a file which contains .RP and .RV commands into 
another file which contains a .DF command. .RP 
will cause repeated printing until all the data in the 


file have been read. i) 


If a number (n) follows .RP, MailMerge reads the 
datafile n times and prints all the documents n 
times. 

¢ Ifa file contains .DF and .RV, .RP followed by a 
number will read the datafile n times and will 
print all the documents n times. 

Chapter 4 explains the uses of .RP as they relate to 

command files and repeated printing. ——> 4-21 

Follow these STEPS to write a .RP command: 

STEP 1 Starting in column one 


TYPE .RP 


PRESS SPACE 


*) 


Oo 


RULES FOR .RP 


AUTOMATIC 
RE-FORMING 


Preparation 


STEP 2. (OPTIONAL) 


TYPE any number 


— 
raerune | 


¢ Put .RP near the beginning of a file and avoid 
using .RP at the end of a file. If you must use 
-RP at the end of a file, follow the command with 
a carriage return. 


¢ .RP has no effect unless a datafile is in use. 


e .RP should not be used unless a .RV is in the 
same file. 


e .RP 0 is the same as .RP 1. Both print the 


document once. 


DOT COMMANDS FOR RE-FORMING 
TEXT AT PRINTING TIME 


When MailMerge inserts variable data into a master 
document, it automatically re-forms paragraphs. The 
WordStar paragraph re-form command “*B works 
similarly. MailMerge looks at the paragraph into 
which the variable data will be inserted. The program 
inspects the margins, the line spacing, and the right 
edge of text to determine if it is justified or ragged 
right. Then MailMerge puts the data in place and 
forms lines of the appropriate length. 


Here is an example of how MailMerge re-forms 
paragraphs which contain variable data. 
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This agreement is made and entered 
into as of the &8DAY& day of &MONTH&, 
1982, between &PARTY 1&, ("Employer") 
and &PARTY2& (“Employee”). 


This agreement Is made and entered 
into as of the thirteenth day of 
November, 1982, between Galactica 
Corporation (“Employer”) and Polly | 
Polaris (‘‘Employee"’). 


Notice that the sample paragraph contains four lines 
on the screen but five lines when printed on paper. 


When MailMerge inserts variable data into a master 
Key document, page breaks may occur differently on 

paper than they do on the screen. To prevent 

awkward page breaks, use the WordStar dot oO 


command .CP to keep certain lines of text on the 
same page. 


The process of adjusting the length of lines of text 
with variable data is called print time line forming. 
Print time line forming is an automatic feature of 
MailMerge. To turn off this automatic feature and to 
adjust justification at printing time, use the dot 
commands .PF, .OJ, and .IJ which are described 
here and on the following pages. 


There are no specific procedures or rules for the use 
of these dot commands because their use depends 
upon your particular formatting requirements. Just 
remember to follow the general rules for writing dot 
commands. 
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Print Time Line Forming. .PF controls the printing 
of lines of text which include variable data. .PF is 
followed by one space and either DIS, OFF, or ON. 
Put these dot commands in column one above the 
lines of text you want to re-form at printing time. 


NOTE: DIS is an abbreviation for ‘discretion’? and 
indicates that a command will go into effect at the 
discretion of MailMerge. For example, when you use 
.PF DIS, MailMerge will start print time line forming 
when it sees a generic name in your text and will stop 
at a hard carriage return. The DIS (discretionary 
situation) is the default or standard situation. 


For most documents, you will allow automatic print 
time line forming. In some cases, however, you may 
want to suppress this feature. For example, suppose 
you want to print client phone numbers on the right 
edge of your text and do not want MailMerge to 
re-form the paragraph and split the number at the 
hyphen. Look at the following example: 


-DF NEW.DTA 
.RV Name, Phone 


This is an example of a situation 
in which you might want to turn 
off the MailMerge feature of 


print time line forming. Suppose 
you want to insert a client's 
phone number in a specific place 
in a letter such as here &PHONESG. 


If print time line forming is on, the telephone 
number will print on two lines. 


phone number in a specific place 
in a letter such as here 767- 


2676. 
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If print time line forming is off (.PF OFF), the a) 
telephone number will print on one line. 


phone number ina specific place 
in a letter such as here 767-2676. 


Turning off print time line forming is useful when 
you want to print data, for example a mailing list, in 
the text of another document. In this case, the 
variable data will extend beyond the margins of the 
text as in the following example: 


.OP 
.DF CUSTOMER.DTA 
-RV N, NAME, TITLE, ADDRESS, CITY-STATE, ZIP, PRODUCT 


.PF OFF 
This might be the text of a document into which you want to insert 


the following variable data: 
&NAME& &ADDRESS& &CITY-STATE& 


This might be the text of a document Into which you want to insert 
the following variable data: 


Patrick Pollux 33 Galaxy Circle Century City, CA 
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If you do not use .PF OFF as in the previous 
example, the printed result might look like this: 


This might be the text of a document into which you want to insert 
the following variable data. 


Patrick Pollux 33 Galaxy Circle Century 
City, CA 


-PF DIS is the default or standard situation in which 
MailMerge automatically forms lines within the set 
margins and re-forms paragraphs after new data is 
inserted. 


-PF OFF stops the automatic feature so that variable 
data which is inserted into text will change the length 
of lines or the form of a paragraph. 


-PF ON turns on print time line forming so that lines 
of text which contain variable data will be reformed 
automatically. 


Output Justification. When print time line forming is 
operating, .OJ determines whether the right margin 
of the text being printed (output) is ragged or 
justified. .OJ is followed by DIS, ON, or OFF and 
only works when print time line forming is on. 


.OJ DIS is the default or standard situation in which 
text that contains variable data is put into the same 
form as the text which was edited. .OJ DIS will re- 
form text that includes variable data into text with 
either a ragged right or a justified margin. 
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.OJ ON forms lines which are justified when print © 
time line forming is on. 


OJ OFF forms ragged right lines when print time 
line forming is on. 


Input Justification. When print time line forming is 
operating, .1J determines whether the right margin of 
the text which has been edited (input) is ragged or 
justified. .IJ is followed by DIS, ON, or OFF and 
only works when print time line forming is on. 


.IJ DIS is the default or standard situation in which 
MailMerge interprets the edited text just as it has 
been entered. The program determines if the input 
(edited text) has a ragged right or a justified margin. 


-IJ ON tells MailMerge to interpret the input (the 
edited text) as justified. 


.1J OFF tells MailMerge the input text should have a 
ragged right margin. 


DOT COMMANDS FOR ONSCREEN 
DISPLAYS WHEN PRINTING 


Two dot commands, .CS and .DM, affect what the 
operator sees on the screen while MailMerge is 
printing. These commands are particularly useful 
when you need to instruct the person printing with 
MailMerge. They are also helpful when you have 
many .AV commands which fill the screen at printing 
time, and you want to clear the screen for easier 


reading. 
— ff 4 Display Message. .DM tells MailMerge to show text 
ja TD] TM on the screen when it prints the master document. 


You can display as many messages as you like. Each 
-DM will cause a line of text to appear below a 
preceding message. The display scrolls up when the 
screen is full. 


oO 
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With this command, you can tell what document is 
being printed, making it unnecessary to look at the 
printer. MailMerge will insert variable data into the 
message if it recognizes generic names enclosed in 
ampersands. For example, you can see what form 
letter you are printing by using a .DM command as 
in the following example: 


This command in the master document will display 
the following message on the screen at printing time: 


P= Stop PRINT 


Now printing letter to Dee Skies 


Here are other examples of .DM commands: 


.DM Now printing Chapter 7 


.DM Load enveiope in printer, press P 


OM Insert next disk in drive B 
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HOW TO WRITE Follow these STEPS to write a .DM command: a) 
A .DM COMMAND 
STEP 1 Starting in column one 
TYPE .DM 
STEP 2. PRESS SPACE 
STEP 3. TYPE your message 


RULES FOR .DM ¢ A .DM command may be no longer than 240 
characters. 


Insert a generic name enclosed in ampersands in 
the command when you want to insert data into 
the message. 


Clear Screen. Put .CS in the master document after 
.AV or .DM commands to make it easier to read the 
screen at printing time. .CS clears the screen when 
MailMerge is printing. Like .DM, .CS can also be 


followed by a message: Oo 


OR 


.CS Enter data when questions appear 
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HOW TO WRITE Follow these STEPS to write a .CS command: 
A .CS COMMAND 
STEP 1 Starting in column one 
TYPE .CS 
STEP 2 (OPTIONAL) 
PRESS SPACE and 


TYPE a message 
RETURN Ff 
end 


USING DATAFILES 


Information stored in a datafile must conform to a 
consistent pattern. The order of fields, the number of 
fields, and the correct use of commas, carriage 
returns, and spacing are extremely important in 
datafiles. You must organize your information or it 
will not merge properly into the master document. 


Consider this example. A mailing list looks like this 
on paper: 


1 Dee Skles 2 Flash Gordon 3 Polly Polaris 


77Sunset Strip 664 Etolle Court 
Hollywood,CA Outer Space Jacksonville,FL 
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Notice that Flash Gordon has no street address. In a o 
mailing list on paper, there is a blank space where 
the street would be. In a datafile, the missing street 

s address is called an empty field. 


A datafile containing your list would look like this 


on the screen: 


1, Dee Skies, 77 Sunset Strip, “Hollywood, CA” 
2, Fiash Gordon,, Outer Space 


3, Polly Polaris, 664 Etoile Court, ‘Jacksonville, FL" 


EMPTY FIELDS Notice that the empty field, the missing street 
address, is marked by an extra comma. Because 
MailMerge ‘‘reads’’ fields by recognizing commas, an 
empty field must be enclosed within commas just as 
a field that contains data would be. Without the 
extra comma for the empty field, MailMerge would 
use the data in the next field as the street address. 


The number is first, the name is second, street 
address is third, city/state is fourth. Another datafile 
might use a different order, perhaps putting names in 
the last field; but the order within a single datafile 
must be consistent. 


Notice that the order of the fields does not change. Oo 


The fields are separated (delimited) by commas, and 
records are separated by carriage returns. Notice the 
last field in the first and third records of the 
example. Because these fields themselves contain 
commas, the entire field is enclosed in quotation 
marks. Though we say that MailMerge ‘‘reads’’ data 
from a datafile, the program really just recognizes 
commas and carriage returns. 


If the variable data in a field contains a comma (for 
example, the city and state ‘‘Hollywood, CA’’), you 
must put double quotation marks around that 
variable data before you use a comma to separate 
fields. ‘Count your commas” is a good rule for 
datafiles. If one record contains an incorrect number 
of commas to separate fields, data will be put in the 
wrong places in a master document. 


Oo 
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You can store information in datafiles either with: 
® MicroPro data and cale products 

OR 
e WordStar in non-document mode 


You can use MicroPro’s DataStar program to design 
a form, enter information (data) on your form, and 
store that data on a record in a datafile. For 
exampie, DataStar will take information such as 
billing address, quantity, and cost from a product 
order form and put it into a datafile. DataStar will 
separate the fields with commas and end each record 
with a carriage return. If you then create a master 
document for a letter that asks for data from that 
file, MailMerge merges that data into the text of the 
letter. 


NOTE: A common extension to the file name of a 
datafile is .DTA. MailMerge will recognize the .DTA 
datafiles from other MicroPro products, such as 
ReportStar and CalcStar, and you can then use that 
data in WordStar document files. 


If you use WordStar to create a datafile, you must 
use non-document mode. In non-document mode, 
word wrap does not function, and tabs are in a fixed 
position. You do not re-form paragraphs when you 
create a datafile. Word wrap and paragraph re-form 
insert soft carriage returns into a file. MailMerge 
does not distinguish between soft and hard carriage 
returns. And a hard carriage return signifies the end 
of a record to MailMerge. 


Because of the horizontal scroll feature of WordStar, 
a record in a datafile can extend beyond the set 
margins. The practical limit, however, is 240 
columns. 
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HOW TO CREATE Follow these STEPS to create a datafile: 


A DATAFILE 
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STEP 1 At the WordStar Opening Menu 
TYPE N 
SEE Name of file to edit? 


STEP 2. TYPE filename 


STEP 3 Starting in column one 

TYPE first item of variable data 
STEP 4 TYPE a comma 

(OPTIONAL) PRESS SPACE 
STEP 5 TYPE variable data in next field 


OR 


TYPE a comma if you lack data for that 


field 


REPEAT STEPS 4 and 5 until you com- 
plete one record (which may be longer 
than one line visible on your screen) 


—- 
[aeruan | 


REPEAT STEPS 3 through 5 until you 


have typed all your data 


STEP 6 Save your file 


Study this example datafile called CUSTOMER.DTA: 


CUSTOMER.DTA 


1,Dee Skies,Astrologer,77 Sunset Strip,""Hollywood, CA",90025,WordStar 


2,Flash Gordon,,99 Nova Avenue,"Dallas, TX" ,75231,DataStar 


3,Patrick Pollux,.33 Galaxy Circle," "Century City, CA",90068,DataStar 


4,Sky King,Rancher,,"“Missoula, MT"",59802, WordStar 


§,Polty Polaris,  SpaceCaseworker 664 Etoile Court,"“Jacksonville, FL",33152, WordStar 


oO 


RULES FOR 
DATAFILES 


a 


ae, 


a7 


Preparation 


Do not create datafiles with WordStar in 
document mode. 


e Use .DTA as the extension to the file name to 
identify it as a datafile. 


© Do not create records in lines longer than 240 
characters. 


e@ Separate fields with commas. 
® End every record with RETURN. 


You may use a carriage return instead of a comma to 
separate fields if, for instance, a record forms a very 
long line on the screen. However, it is not 
recommended. DataStar and some other programs 
recognize only commas to separate fields and only 
carriage returns to separate records. You must follow 
the same format in creating a datafile with WordStar 
in non-document mode. Otherwise, you will not be 
able to use that datafile with other programs. 


Never use RETURN in the middle of a field. 


¢ If a field contains a comma or is preceded or 
followed by a space, surround the field with 
quotation marks. Make sure that the commas 
which separate fields are outside of the quotation 
marks. 


e Never omit a field. If you have no data, create an 
empty field using an optional space and a required 
comma. 


MailMerge will not work if the last field in the last 
record of a datafile is empty. 


e Never vary the order of fields in a datafile. 
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8 4. Printing 
...Starting...interrupting... 
chain printing...nested printing... 
command files...copies... 


Printing with MailMerge is as simple as typing M at 
the WordStar Opening Menu. But your choice of dot 
commands will produce a variety of sophisticated 
results. This chapter explains the following: 


printing 

chained printing 
nested printing 
combined task printing 
duplicate printing 
repeated printing 


You can not edit while you print with MailMerge. 


SS, 


MailMerge 


HOW TO START 


Follow these STEPS to print a document file which 
contains MailMerge dot commands: 


STEP 1! At the WordStar Opening Menu 
TYPE M 


STEP 2 You see the prompt 


Name of file to MailMerge? 


TYPE the name of the file which contains 
MailMerge dot commands 


STEP 3 Ready the printer 
STEP 4 PRESS ESCape and print 


OR 


\[ReTuRN J to print with options 


You see the prompts 


not editing 


Name ot file to MailMerge? letter 

For default press RETURN for each question: 
Disk file output (Y/N): 
Start at page number (RETURN for beginning)? 
Stop after page number (RETURN for end)? 
Number of copies (RETURN for 1)? 
Use form feeds (Y/N): 
Suppress page formatting (Y/N): 


Pause for paper change between pages (YIN): 
Ready printer, press RETURN: 


* 


Oo 


Printing 


Oo NOTE: Your response to the fourth question 
determines the number of duplicate copies to be 
printed, 


STEP 5 You see the prompts 


Mat!Merge printing (name of tile) not editing 


= Stop PRINT 


NOTE: Printing with options in MailMerge is very 
similar to printing with options in WordStar. Consult 
your WordStar Reference Manual for an explanation 
of these options. 


HOW TO STOP 


While MailMerge prints, you see P = Stop PRINT 
highlighted on your screen. 


Follow these STEPS to stop printing: 
STEP 1 TYPEP 


STEP 2 You see the prompt 


PRESS Y 


Typing P to stop printing will not always work. If 

"your document contains a .AV command and the 
cursor is resting after a question on the screen, ‘‘P”’ 
will be interpreted as data. See the following 
instructions. 
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IF MAILMERGE 
IS WAITING FOR 
DATA FROM AN 
OPERATOR 


Follow these STEPS if there is a question on the 
screen requesting data: 


STEP 1 You see the cursor positioned after a 
screen prompt 


PRESS *U 


STEP 2 You see the prompt 


»* *INTERRUPTED* * *Press ESCAPE Key 


PRESS ESCape and rapidly TYPE P 


STEP 3 You see the prompt 


“Y" to abandon print, “‘N" to resume, “U to hold 


TYPE ¥ 


HOW TO INTERRUPT 


Perhaps you want to change the ribbon or insert 
envelopes into the printer. You can command 
MailMerge to interrupt printing at any one of three 
stages: 


¢ Before you save the file which you will print 
e After you save the file but before you print 


¢ While you are printing the file you saved 


i) BEFORE SAVING 


THE FILE AND 
PRINTING 


AFTER SAVING 
THE FILE AND 
BEFORE 
PRINTING 


Printing 


Follow these STEPS to interrupt before saving the 
file and printing: 


STEP 1 Open a file 


STEP 2 At the top of the file, before the dot 
commands 


PRESS °P 
TYPE C 
You see on the screen: “C 


STEP 3. Enter dot commands and text 


STEP 4 _ Save the file 

STEP 5 At the Opening Menu, print with MailMerge 
MailMerge will print. When it encounters the “C in 
your file, MailMerge will stop printing, and you will 


see the WordStar Opening Menu. On it, you will see 
highlighted: 


P Continue PRINT 


Follow these STEPS to interrupt after saving the file 
and before printing: 


STEP 1 PRESS M 


STEP 2 You see the prompt 


Name of file to MailMerge? 
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DURING 
PRINTING 


TYPE filename © 


PRESS [[reruay | 7 times 


STEP 3 You see the prompt 


Pause for paper change between pages (Y/N): 


TYPE Y¥ 


ica 


Follow these STEPS to interrupt during printing: 
STEP 1 PRESS P 


STEP 2 You see the prompt 


“Y" to abandon print, “N" to resume, @U to hold oO 


PRESS *“U 


You see the prompt 


** "INTERRUPTED °° *Press ESCAPE Key 


STEP 3 PRESS ESCape 


You see the WordStar Opening Menu. On 
it, you will see highlighted 


- P Continue PRINT 


Oo 


Printing 


CHAIN PRINTING 


With chain printing, you can join many files—files 
holding chapters of a book, for example. If you put 
a .Fl command at the end of each file and then print 
the first file, MailMerge automatically links the other 
files in the chain. 


B:CHAP 1 


This is the first chapter. 
«FL CHAP 2 


BCHAP.2 


This is the second chapter 
FLA.CHAP.3 


A:CHAP.3 


This ts the third chapter. 


By printing CHAP.1 with MailMerge, you will get 
this result: 


This is the first chapter 
This is the second chapter. 


This is the third chapter. 


MailMerge 


HOW TO 
PRODUCE CHAIN 
PRINTING 
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NOTE: Chapters can be put on disks in different 
drives as in the previous example. 


BLM 


Follow these STEPS to produce chain printing: 


STEP 1 
STEP 2 
STEP 3 


STEP 4 


STEP 5 


STEP 6 


Open a file 

TYPE the text 

Move the cursor to end of the file 
Starting in column one 


(OPTIONAL) TYPE .PA if you want the 
next file to start on a new page 


[DReTuan | 
TYPE .FI 


If the file to be chained is not located on 
the logged disk drive, 


TYPE the letter naming the disk drive and 
a colon. 


Oo 


* 


oO 


Printing 


STEP 7. TYPE the name of a file to be next in the 
chain 


STEP 8 Save the file 
REPEAT STEPS | through 8 


STEP 9 At the Opening Menu, print with 
MailMerge 


OR 
Use a command file to produce chain 


printing. @—» 4-12 


NESTED PRINTING 


Nested printing is a valuable tool for including a 
standard paragraph in many different documents. 
When you want to put an entire file inside another 
and another inside of that one and still another 
inside of that one (up to seven times), use nested 
printing. 


Nesting can also mean putting many files inside of 
one file. There is no limit to the number of files that 
can be nested this way. 


MailMerge 


HOW TO 
PRODUCE NESTED 
PRINTING 
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Follow these STEPS to produce nested printing: 


STEP } 
STEP 2 


STEP 3 


STEP 4 


STEP 5 


STEP 6 


STEP 7 


STEP 8 


Open a file 
TYPE the text 


Move the cursor to the place where you 
want to insert another file 


Starting in column one 
TYPE .FI 
PRESS SPACE 


If the file to be inserted is not located on 
the logged disk drive, 


TYPE the letter naming the disk drive and 
a colon 


TYPE the name of the file to be inserted 


ite 


Continue with the text 


o 


RULES FOR 
NESTED 
PRINTING 


Printing 


STEP 9 Save the file, then either 
STEP 10 Open file named in STEP 7 


REPEAT STEPS 2 through 9 no more 
than six times 


OR 


STEP 1! REPEAT STEPS | through 9 any number 
of times 


STEP 12 Print the file opened in STEP | with 
MailMerge 
e You can nest as many as seven files inside one 


another (see illustration #1). 


e You can nest as many files as you like in one file 
(see illustration #2). 
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COMBINED TASK PRINTING WITH 
COMMAND FILES 
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With MailMerge, you can combine several printing 
tasks by creating one special file called a command 
file. This command file will find the files you specify 
and print them in succession. For example, when you 
want to print letters and envelopes, you only need to 


print once. 
a Z| 
oA ns Bs nes zy EZ =| 
LAL, Z a 
aE 


iZe 


g Z =) 


= ee 
\Lacid«E, 
G7 


A command file is a document file with little or no 
text in it and no specific form. It can be as simple as 
a series of .FI commands to chain files, which could 
be, for example, the chapters of a book. Or a 
command file can contain a complex series of 
commands that print many master document files, 
each of which uses a datafile. However you design a 
command file, when you print that file with 
MailMerge, all the dot commands will go into action. 


oO 


Printing 


it) MAILING LIST The example which follows illustrates what happens 
TASKS when a command file for printing letters and 
matching envelopes is printed with MailMerge. 


B:COMMAND 


Leseefesee eseebecee fennel 


DM Print letters, then envelo, 

AV "Enter name of letter file’, LETTER 
AV “Enter name of datafile", DATAFILE 
Fl LETTERS 

Fl ENVLOFES, 


MailMerge displays these messages on the screen, and 
the operator types the following responses, pressing 
RETURN after each response. 


Print letters, then envelopes 
Enter name of letter file: FORM.LTR 
Enter name of datafile: CUSTOMER.DTA 
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MailMerge finds the file called FORM.LTR. a) 


B:FORM.LTR 


[ieee ees bere Bees Bree Bonen eee Beoes Bee Domed beens Bacal Donen Bone | 
DF &DATAFILE& 

«RV N.NAME, TITLE,STREET,LOCALE,ZIP,PRODUCT 

&NAMES 

&TITLE/O& 

&STREETIO& 

&LOCALE& &ZIP& 

Dear &NAME&, 


MailMerge finds the datafile called CUSTOMER.DTA. 


B:CUSTOMER.DTA 


1,Dee Skies,Astrologer,77 Sunset Strip,“Hollywood, CA”,90025,WardStar 
2,Flash Gordon... 
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Printing 


© MailMerge inserts the data into the letters and prints 
the letters. (MailMerge will pause for a paper change 
if the operator prints with options and requests a 
pause.) 


Dee Skies 
Astrologer 

77 Sunset Strip 
Hollywood, CA 90025 


Dear Dee Skies, 
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MailMerge finds the file called ENVLOPES. a) 


B:ENVLOPES 


‘DF &DATAFILES 
RV N.NAME, TITLE,STREET,LOCALE,21P.PRODUCT 


&NAME& 
&STREET& 
SBLOCALES &ZIP& 


MailMerge finds the datafile called CUSTOMER.DTA. Oo 


B:CUSTOMER DTA 
1,Dee Skies,Astrologer,77 Sunset Strip." Hollywood, CA" ,90025,WordStar 


2,Flash Gordon,... 


MailMerge inserts the data and prints the first 
envelope. 


Galactica Corporation 
508 Halibut Ave. 
Ether City, CA 94706 


Dee Skies 
77 Sunset Strip 


Hollywood, CA 90025 
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oO 


CHAIN 
PRINTING 


Printing 


MailMerge pauses for the operator to put the next 
blank envelope in the printer and then continues to 
print and to pause until envelopes for every customer 
have been printed. 


You can use a command file to chain files together. 
Rather than putting .FI commands at the end of each 
file. make a command file with several .FI 
commands. When you give MailMerge the name of 
your command file, it prints all the files in 
succession. 


Look at the following example. If you print the 


command file called B:BOOK.TXT, Chapters 1, 2, 
and 3 will automatically be printed. 


B: BOOK.TXT 


-Fl CHAPTER1. TXT 


-Fi CHAPTER2 TXT 
“Fl CHAPTER3.TXT 


NOTE: You can even use a command file to print a 
book that is large enough to fill several disks. Type 
the word CHANGE at the end of the .FI command 
if the file named is on another disk. Look at the 
following example. Chapter 3 is not on the same disk 
as Chapters | and 2. 


B: BOOK TXT 


Fl CHAPTER? TXT 


-Fl CHAPTER2 TXT 
Fi CHAPTERS TXT CHANGE 
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ASK FOR 
VARIABLES 
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A command file is useful when printing form letters © 
that ask the operator to insert variables. For 
example, perhaps you send out monthly bills that 
require an operator to enter the current date. If the 
-AV command for the date is put in the master 
document, the operator must type the date for every 
bill printed. However, if the .AV command is put in 
a command file and the generic name is enclosed in 
ampersands in the master document, the operator 
need only type the date once, and it will appear on 
every bill. 


The following example shows a command file for 
printing monthly bills. If the command file were 
printed with MailMerge, a message would appear 
telling the operator that monthly bills were being 
printed. Then a message requesting a date would 
appear. After the operator typed the date, MailMerge 
would print monthly bills with the correct date for all 
the names in the datafile called CUSTOMER.DTA. 


B:COMMAND.BIL 


.DM “Printing monthly bills" 
AV “Enter today's date:"”, DATE 
.FI BILL 


B:BILL 


.DF NEW CUST.DTA 
-RV NAME, ADDRESS, AMOUNT 
&DATE& 
TO: &NAME& 
&ADDRESS& 


Your bill this month is SAAMOUNT& 


Printing 


By using a command file, you can print a letter using 
different datafiles at different times. This command 
file could be useful, for example, when you have a 
mailing list composed of several files or even several 
disks. 


Also, a command file could contain .AV commands 
which ask for the names of a master document file 
and of a datafile. The master document file would 
contain .DF and .RV commands. Instead of 
containing specific file names, the .AV, .FI, and .DF 
commands would use variable names for the type of 
file requested. 


The following example illustrates this use of the 
command file. (Refer also to the example in the 
section on command files and mailing list tasks in 
this chapter.) ~@_» 4-13 


When printed with MailMerge, the command file in 
this example would first display a message on the 
screen telling the operator that form letters were 
being printed. Then prompts requesting the names of 
a letter file and a corresponding datafile would be 
displayed. After the operator typed the responses, 
MailMerge would print the form letter. When it 
encountered .DF &DATAFILE& in the form letter, 
MailMerge would go to the datafile named by the 
operator, read the data, insert it into the master 
document, and print versions of the form letter. The 
operator could then print the same command file 
again but name a different datafile, and MailMerge 
would print another series of form letters. 


B:COMMAND LET 
ee eee eee Pemen| lee es ee] Deo] ee Eon] Bees] ta Bs a 


.OM Print form tetters 
AV" Enter file name of leiter to print:"", LETFILE 


.AV “Enter file name of datafile:", OATAFILE 
Fl &LETFILES 
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B:LETFILE 


eee eee eee ee ee eee ee Boe Be Eee ees oe ee | 
.OF &D0ATAFILE& 
.RV NAME, ADDR1, ADDR2 


&NAME& 
SADDR1& 
&ADDR2& 


Dear &NAME&, 


This is a personalized form letter created by MailMerge, the newest addition to 
my MicroPro family. ° 


MAKING COPIES 


There are three kinds of copies in MailMerge: 


e Duplicate copies. MailMerge can produce many 


copies of the same document just as a copy 
machine can. 


Repeated printing. This is the ‘‘form letter’ 
concept. MailMerge will print a master document 
repeatedly, changing data in each copy. 


Duplicate copies of documents that are the result 
of repeated printing. MailMerge can combine the 
two types of printing listed above to produce 
many copies of a form letter. Or it can produce 
another document in several versions. 


o 


oO DUPLICATES 


Printing 


Before you print, follow these STEPS to print 
duplicate copies of a document: 


STEP 1 Open the file you want to print 


STEP 2 Starting in column one at the beginning of 
the file 


TYPE .PN 1 
AND 


TYPE .RPn (n is number of copies 
desired) 


At the start of printing, follow these STEPS to 
produce duplicate copies: 


STEP 1 [[rewar 4 times 


STEP 2 You see the prompt 


Number of copies? 


for one copy 


OR 
TYPE any number 
STEP 3 [Lrewan ] 


STEP 4 PRESS ESCape 
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REPEATED 
PRINTING 
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Follow these STEPS to produce repeated printing: 


STEP 1 


STEP 2 


STEP 3 


STEP | 


STEP 2 


STEP 3 


Create a master document that includes 
-DF and .RV commands 


Create a corresponding datafile 
Print the master document with MailMerge 
OR 


Create a master document that includes 
-RV and .RP commands 


Create a datafile 


Create a command file that contains a .DF 
command that names the datafile in STEP 
2 and a .FI command that names the 
master document file in STEP 1. 


* 


Oo 


© 


WHAT IS 
CONDITIONAL 
PRINTING? 


HOW DOES 
CONDITIONAL 
PRINTING WORK? 


5. Conditional Printing 


...using dot commands for conditional 
printing... 


Conditional printing lets you include selected text in 
some copies and delete it from others. You use two 
dot commands, a conditional command and an end 
command, to specify what should or should not be 
printed. In everyday life, a conditional command 
might sound like this: ‘“‘If the coat is dirty, send it to 
the cleaners.’’ In word processing, you might use a 
conditional command to say, ‘“‘If the parties to this 
contract are corporations, use the long form.’’ Or if 
you are a fund raiser using MailMerge, you could 
specify, ‘Except for donors who gave more than 
$1000 last year, ignore the last paragraph of this 
letter.”’ 


First, you put into a master document a conditional 
command that states, ‘‘IF this is so,’’ or “EXCEPT 
when this is so, skip to the place marked below and 
resume printing.’’ For example, a conditional com- 
mand could say, ‘‘If the zip code is 94114, go to the 
second paragraph and print.’’? The master document 
contains a .RV, .AV, or .SV command which would 
supply the data (the zip code, in this example) to 
MailMerge. 


MailMerge 


.e @ @ & ena command then pr 


Cre this is true, Zo to the “2 
tee 


x 


A ylpth (Zin by pba 


i? i! 


Lys fey 


Next, you put another dot command, called the end 
command, in the master document. The end com- 
mand marks the place where you want MailMerge to 
resume printing. 


Finally you save your file and press M at WordStar’s 
Opening Menu. MailMerge reads the conditional 
command and compares the data in the command to 
the variable data supplied by a .RV, .AV, or .SV 
command. The program then prints the selected 
paragraphs or documents. 


Conditions 


Here are two examples of master documents for con- 
ditional printing: 


DF ADDRESS DTA 

-RV N.NAME,STREET,CITY,STATE,ZIP. 
&NAME& 

&STREET& 

&CITY& 

&STATE& &ZIP& 


Dear &NAMES, 


We are pleased to send you our new winter gitt catalogue You will find an 
ordet form on the back cover of the catalogue 


IF &STATE& = “California” GOTO 
Your oui-of-state order w.ti be procossed soonac it you specify air freight 
delivery on the order. 


€F 
We extend holiday greetings to you and your family. 


Sincerely, 
Plaza Designs 
PA 


In the previous example, the conditional command 
tells MailMerge, ‘‘If the state is California, skip this 
paragraph and print what you see after the .EF com- 
mand.’’ MailMerge would not print the center 
paragraph in letters sent to California residents. 


OP 

OF ADDRESS.DTA 

RV N,NAME,STREET,CITY,STATE,ZIP 
EX &ZIP& = 94611" GOTO 
&NAME& 

&STREET& 

BCITY& 

&STATE& &ZIP& 


Dear &NAME& 


Happy New Year from your local grocer. 


Sincereiy, 
Grace the Grocer 
:PA 


EF 
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In the previous sample, the conditional command 
tells MailMerge, ‘‘Except when the zip code is 94611, 
go to the .EF and print.’’ Because the end command 
is at the end of the file, MailMerge will find nothing 
to print for zip codes other than 94611. As a result, 
MailMerge prints letters only to the zip code area of 
94611. 


COMPONENTS OF CONDITIONAL 
PRINTING 


A conditional command that begins with the dot 
commands .JF or .EX orders MailMerge to compare 
the data supplied by a .RV, .AV, or .SY command 
to the data in the conditional command itself. 


A conditional command can be simple or complex. 
Procedures for writing these commands appear later 
in this chapter. 


A simple conditional command contains each of the 
following elements in this order: 


¢ a dot command .IF or .EX 
© an expression 


© a terminator 


Conditions 


The following examples show some simple condi- 
tional commands: 


Expression 


Dot Command 


Terminator 


IF &CITY& = "San Francisco” GOTO 


( €X &ZIP& = “94118 GOTO ) 
-IF 8AMOUNT& >"'50" GOTO 


A complex conditional command not only has all the 
elements of a simple command but also may contain 
the following: 

© more than one expression 


e a label 


°* acomment 


MailMerge 


Notice the elements of a complex conditional com- Oo 
mand in the following examples: 


Dot Command Terminator 


Two Expressions 


IF 8ADDR& = "San Francisco” .OR. B&ADDR& = ‘San Rafael” GOTO 
.EX &ZIP& < = "99999" AND, &ZIP& > "89999" GOTO NEXTLETTER 
IF &REPORT& = “Annual GOTO; Joe, please check figures In cfu) 


Comment Label 


es \ia Jia | An end command begins with the dot command .EF. 


It marks the position in a document where 
MailMerge will resume printing if the conditions in a 
conditional command are true. 


*) 


An end command contains: 
e the dot command .EF 
® a label (optional) 


You can put an end command below any text to be 
conditionally printed. 


NOTE: There must be text between the conditional 
command and the end command. 
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Conditions 


a) Notice the positions of the end commands in the 
following example. The label ‘“NEXTSECTION,”’ 
though not required, distinguishes the second end 
command from the first. 


OP 

.DF ADDRESS.DTA 

«RV N,NAME,STREET,CITY STATE,ZIP 

AF &ZIP& = "94901" GOTO 

This is a form letter with paragraphs for all zip codes except for 94901 which 
has its own special paragraph bolow. 


.EF 
.EX &2ZIP& = 94901" GOTO NEXTSECTION 
This 1s the special paragraph for zip code 94901 


EF NEXTSECTION 
This paragraph prints for all zip codes. 
PA 


You can also put an end command at the very end of 
a file if you do not want MailMerge to print any of 
the text in the file. This placement may seem odd, 
but it tells MailMerge to return to the top of the file 
to print if the condition is met. 


MailMerge 


The following example shows the use of the end we) 
command at the end of a file: 


OP 

.OF ADDRESS.DTA 

RV N.NAME.STREET.CITY,STATE,ZIP 

AF &ZIP& = "94901" GOTO 

This is a form letter with one paragraph that will be sent to all zip codes 
except 94901. 


It follows the dot command .IF or .EX and comes 
before the terminator, GOTO. An expression is a 
statement that specifies the condition(s) for printing. 
An expression contains the following elements in this 
order: 


EXPRESSIONS An expression is the heart of a conditional command. ae) 


© a generic name enclosed in ampersands 
* a comparison character 


* an item of variable data enclosed in quotation 
marks 
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COMPARISON 
CHARACTERS 


Conditions 


Here are two examples of expressions: 


&NAME& = Rodriguez 


In an expression, the generic name always comes 
first, the comparison character next, and the data 
last. A space before and after a comparison character 
is optional. 


A comparison character is a symbol placed between 
the generic name and the variable data in an expres- 
sion. If you change the comparison character in an 
expression, you will affect the conditional printing 
even though the generic name and the variable data 
remain the same. For example, a conditional com- 
mand that states, ‘‘If the zip code is greater than 
50000,”’ will produce different results from one which 
states, “If the zip code is equal to or less than 
50000.”’ 


MailMerge recognizes these comparison characters: 


Character Meaning | 

= equal 

<> not equal 

< fess than 
> greater than 

<= less than or equal to 

ae equal to or less than 

>= greater than or equal to 
=> equal to or greater than 


5-9 


MailMerge 


These symbols compare strings of characters, whether Oo 
the strings are made up of letters, numbers, or other 
keyboard symbols. MailMerge reads characters in a 
particular sequence (ASCII Collating Sequence) that 
establishes a hierarchy of characters. The following 

line shows a portion of this sequence: 


Se ccsoestes Dene teen e renee eee beeen neneees GREATEST 


0123456789ABCDEFGHIJKLMNOPQRSTUVWXY ZabcdefghijkIlmnopqrstuvwxyz 


Therefore, just as 8 is greater than 3, so is N greater 
than 9 and r greater than R. This hierarchy makes it 
possible to select only a portion of a mailing list for 
printing. 


For example, if you want to send out bills to those 
clients whose names begin with D, you would con- 
struct the following expression: 


EX &NAME& >= “D" AND. &NAME& < ""E” 


oO 


As another example, suppose you want to print 
registration forms for those students whose last 
names begin with the letters from A to L. You would 
use either of the following expressions: 


.EX &NAME& << iz 
LIF &NAME& > = “M" 


Conditions 


a) TERMINATORS A terminator is the word or letter which ends a con- 
ditional command. You must use ‘‘GOTO”’ or 
“goto’’ or ‘‘G”’ or ‘‘g.’? A space preceding the ter- 
minator is optional; a space following is required if 
you add a label or comment to a conditional 
command. 


LABELS A label is a string of one to twenty characters that 
follows a space after the terminator of a conditional 
command. That same labe! must follow the cor- 
responding end command. 


Here is an example of a label after a conditional 
command: 


IF&ZIPR =""94441"GOTO PARAGRAPH23 


Here is the same label after an end command: 


.EF PARAGRAPH23 


A label never starts with a number and never 

includes spaces. (You may use numbers elsewhere in 
a label, however.) Use hyphens where you want 
spaces. 


When you use a Series of conditional commands and 
end commands in one long document, and you want 
to distinguish one from another, use labels. 
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MailMerge 


The following example shows where you would use 
labels in a long document. The dot commands 
required to supply variable data are not included. 


.IF &CITY& = ‘'New York" GOTO EASTERN-REGION 
.IF &AMOUNT& > ''76,000" GOTO LONGFORM 


This might be several pages of text. 


.EF EASTERN-REGION 


Again several pages of text might follow. 


.EF LONGFORM 


More text would follow. 


COMMENTS A comment is a message that can be typed after a 
space and a semi-colon at the end of a conditional 
command. MailMerge does not print comments or 
display them on the screen at print time. They re- 
main in your file to give special instructions to the 
operator. 


Here is an example of a comment following a 
command: 


&NAME& = “Big Bucks” GOTO ;Put this appeal on my personal letterhea 
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Conditions 


MASTER DOCUMENTS 


HOW TO WRITE 
CONDITIONAL 
COMMANDS 


Before you can produce any conditional printing, you 
must create a master document with commands and 
text in this order: 


enter commands which supply data to MailMerge 
(.DF and .RV or .AV) 


enter text (optional) 

enter one or more conditional commands 
enter text or dot commands 

enter one or more end commands 


enter more text (optional) 


You custom design your own master document for 
conditional printing, depending upon what you want 
to include or exclude. The form will vary because 
you can use simple or complex conditional commands 
in series or singly. 


Follow these STEPS to write a conditional command: 


STEP {Starting in column one 


TYPE .EX (‘‘except’’) 
OR 


TYPE .IF (‘‘if?’) 


STEP 2. PRESS SPACE 


STEP 3. TYPE generic name enclosed in 


ampersands 
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STEP 4 PRESS SPACE a) 
STEP 5 TYPE a comparison character 


STEP 6 TYPE variable data enclosed in quotation 
marks 


Do not use dollar ($) signs or other symbols in a 
a4 command or in a datafile. Put the dollar sign in your 
text instead. 


STEP 7 PRESS SPACE 


STEP 8 TYPE GOTO 


[sevor | 
RULES FOR ¢ You can put a conditional command anywhere 
SIMPLE in your file. 
CONDITIONAL 
COMMANDS e Never use .EF immediately after .EX or .IF. 
e There is no limit to the number of conditional a) 


commands you can use. 


HOW TO WRITE To write a complex conditional command, follow 
COMPLEX STEPS 1 through 7 of ‘‘How to Write a Simple Con- 
CONDITIONAL ditional Command.’’ Then continue with the STEPS 
COMMANDS that follow: 


STEP 8 (optional) (to add more expressions) 


TYPE .AND. 
OR 
TYPE .OR. 


The periods (dots) before and after the words OR 
7 and AND are essential. Do not leave them out. 
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Conditions 


© Conditional commands can not exceed a total length 
. of 100 characters. 


STEP 9 REPEAT STEPS 2 through 7 above 
AND 
TYPE GOTO 
AND 
STEP 10 (optional) 
After GOTO 
PRESS SPACE 
TYPE a label 
TYPE same label after end command 


OR 


PRESS SPACE 
TYPE a semicolon (5) 


TYPE comment 
STEP 11 eu] 


RULES FOR ¢ You can join several expressions with .AND. 
COMPLEX or .OR.. Periods and uppercase letters are 
CONDITIONAL essential, 

COMMANDS 


* A conditional command may not be more than 
100 characters long. 


© Never start a label with a number. 


© There is no limit to the number of conditional 
commands you can use. 


Ld 
oF 
3 
=, 
= 
= 


gsuol 
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HOW TO WRITE 
AN END 
COMMAND 


RULES FOR .EF 
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Follow these STEPS to write a .EF command: 


STEP 1 Put a conditional command in a document 
file 


STEP 2. Starting in column one, above text 
TYPE .EF 
STEP 3 (optional) 


TYPE a label identical to the label at the 
end of a conditional command. 


— 
I[aeruen J 


e .EF only works in a document file that contains a 
conditional command. 


¢ There is no limit to the number of .EF commands 
that can be used in a document file. Just be sure a 
-EF corresponds to a conditional command (.IF or 
.EX). 


¢ Never put .EF directly under a conditional com- 
mand. Text or hard carriage returns must come 
between a conditional command and an end 
command. 


Oo 


) 


OPERATING 
SYSTEM 


CPU MEMORY 


VIDEO TERMINAL 


PRINTER 


DISK STORAGE 


MAXIMUM 
FILE SIZE 
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Program Specifications 


WordStar and its cptions, MailMerge, and SpellStar 
operate only if the following specifications are met. 
Most WordStar specifications apply also to the 
options. Any special requirements are noted below. 
For information regarding specific versions of 
WordStar and its options, see your dealer. 


WordStar 


CP/M (version 2.0 or higher) 
CP/M-86 

MP/M 

MS-DOS 

PC-DOS 


For 8-bit microcomputers: 
56K of memory (RAM) or 
50K of program memory 


For 16-bit microcomputers: 
64K of memory (RAM) 
except CP/M-86: 80K (RAM) 


WordStar requires an addressable cursor or byte- 
addressable, memory-mapped video. Minimum screen 
size is 16 lines by 64 characters. Maximum screen size 
is 57 lines by 120 characters. 


WordStar can take advantage of most of your 
printer’s capabilities, whether letter or draft quality. 


WordStar can operate with one drive containing at 
least 120K. Use 5 1/4’? or 8’ disks, depending on 

your hardware. For convenience, two floppy disk 

drives are recommended. 


8 megabytes on CP/M, CP/M-86, and MP/M. 
Unlimited on MS-DOS and PC-DOS. 


DISK STORAGE 


SpellStar 


MicroPro recommends that you run SpellStar with 
two floppy disks of at least 128K each, although you 
can check a very small document with a small 
dictionary on one disk of at least 128K. 
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MailMerge Error and Warning 
Messages 


MailMerge has a number of error and warning 
messages which can appear when you print. An error 
message is always displayed for an invalid dot 
command; other conditions, such as a file not found, 
will produce warnings. Although printing proceeds 
after the error message or warning, the printout may 
be incomplete or incorrect. 


Can't edit a file while MailMerging—Finish or abandon MailMerge before editing 


If you interrupt printing with MailMerge, you will 
see the WordStar Opening Menu on the screen with 
“P Continue Print’’ highlighted. If you press D to 
open a file you will see the warning message above. 


*** Invalid Dot Command Ignored: 


An incorrect dot command is displayed on the next 
line. In some cases, a specific error message 
accompanies this message. 


*** Insert diskette with file *_"":filename.typ then press RETURN 


This is not an error message but a request to insert 
the disk containing the specified file into the disk 
drive indicated before the file name. This request 
results from processing a .DF or .Fl command 
containing the word ‘“CHANGE”’ (or anything begin- 
ning with ‘‘CH’’) after the file name. 
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The disk cannot be removed because MailMerge has 
found a .DF or .FI command with the word 
“CHANGE” after the file name and the disk drive 
specified in the file name (or the logged drive if no 
specific drive was specified) contains a file which 
MailMerge is using. 


To avoid this error, keep WSMSGS.OVR, 
WSOVLYI1.OVR, the master document being printed, 
the disk output file (if in use), and all datafiles and 
inserted document files used by the master document 
(but not on disks to be changed) on the logged drive. 
Use drive B (in a two-drive system) for CHANGE 
files, using only one CHANGE file at a time. 


After the error message is displayed, MailMerge will 
still attempt to find the file, even if the correct disk 
has already been inserted. If the file is not found, the 
next message appears. 


*** File D:filename.typ Not Found 


If the file specified in a .Fl or .DF command is not 
on the specified drive nor on the logged drive (if no 
drive was specified in the command), MailMerge will 
look further (see next message). Then, if the file is 
not found,MailMerge will proceed without it. For a 
.FI command, printing will continue with the line 
after the .FI command; for a .DF command, printing 
will continue with no datafile, in which case a further 
message will appear when a .RV command is 
encountered. 


*** But found, and will use, D:filename.typ 


If no file is found (see preceding message), 
MailMerge looks on the logged drive and on drive A 


for a file with the same name and finds it. If the file 
was merely on the wrong drive (or you had the 
wrong drive logged), this may be the correct file. 


However, if you had a file with the same name but 
different contents on another disk, this may be the 
wrong file, and the resulting printout may be wrong. 
Check carefully. 


*** No DF before RV 


Either a .RV command was encountered with no 
preceding .DF, or the datafile specified in the .DF 
was not found. If no ‘‘File Not Found’’ message 
appears above on the screen, check your document to 
make sure the .DF is present and placed before the 
-RV. Printing proceeds with no data supplied for the 
variables; the generic names and &’s will print, and 
only one copy of a master document will be printed. 


*** WARNING. Overlong data value truncated 


If one or more data items is longer than the max- 
imum allowed (200 characters) only the first 200 
characters will be used. The extra characters may be 
skipped over or used (incorrectly) as the value for the 
next variable. This message may indicate an error in 
datafile format, such as an omitted second quotation 
mark (’’). 


*** Invalid variable name in .RV command ignored 


One or more of the generic names in a .RV 
command was not in valid form (a letter followed by 
0-39 additional letters, digits, or hyphens). The 
message may indicate that &’s should NOT be used 
in a .RV command. 
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WARNING. Data exhausted, nul! value(s) used 


The end of the datafile was reached in the middle of 
the execution of a .RV command. The last record of 
the datafile did not contain the number of items 
required to print another letter (or other document). 
The generic names for which no data are present are 
given ‘‘null’’ values (values consisting of no 
characters) and printing proceeds. Printing will 
normally stop after this message appears and 
MailMerge reaches the end of the document being 
printed. 


This message commonly indicates an error in the last 
record of the datafile. The message may also indicate 
use of the wrong datafile (one with an inappropriate 
number of data items per record) or indicate that an 
omitted item or comma earlier in the file caused an 
incorrect matching of the datafile with the letters. 
(The latter case of getting and staying ‘‘out of 
synch’”’ can only occur if carriage returns are used in 
the datafile between items for the same letter as well 
as between records. Use of commas only is 
encouraged to facilitate ‘‘re-synching”’ after an 
omitted item.) 


NOTE: This message will appear only when the end 
of the datafile is reached. Earlier errors or the 
presence of fewer variables in the datafile record 
(line) than in the .RV command may have caused 
incorrect matching of data throughout the print run. 
If .RV finds insufficient values on a datafile line, it 
proceeds automatically to following lines until 
enough data has been found. 


NOTE: Each time the end of a document being 
processed with .DF/.RP is reached, MailMerge looks 
ahead in the datafile, passing up all carriage returns 
and blanks present, to see if more data is present. 
The message above will not occur and the document 
will print if the end of the file is reached before any 
non-blank, non-carriage return character is found (as 
it will be after the last letter if the datafile matches 


oO 


the document correctly and has a correct last record). Oo 


Sometimes you can ignore this warning. If, for 
example, you are printing mailing labels which read 
multiple ‘‘records’’ for each printout, the above 
message may appear. For instance, a document that 
prints 3-up address labels would read three name and 
address records (typically with three .RV’s) on each 
repetition, then print the three labels. This document 
would get the above warning at the end, unless the 
number of records in the datafile happened to be a 
multiple of three. Then, the warning may be 
disregarded. The one or two labels for which no data 
is present would not print, since .RV automatically 
supplies null values for the absent data. 


Appendix C 
MailMerge Applications 


1. Creating a Mailing List Datafile from an 
Existing Datafile 


MailMerge can simplify your mailing tasks by 
creating a mailing list datafile. Suppose you want 
MailMerge to produce an address list from a 
comprehensive datafile created by DataStar. There is 
no need to design a new form for customers’ names 
and addresses. The trick is to use a MailMerge 
command file to extract names and addresses from 
an existing invoice file, in this case, INVOICE.DTA. 
This command file contains dot commands and 
generic names on one line with a comma separating 
each field of the record. You do not print the 
command file but request an output file when you 
run MailMerge. The output file is a new datafile 
which you can open and edit in WordStar’s non- 
document mode or use immediately for mailing list 
tasks. 


The following example illustrates how to create a new 
datafile from this existing datafile called 
INVOICE.DTA: 


B:INVOICE.DTA 
02/24/82,7,Ms. Lydia Esther, Womack,8993 Cherry Ave San Leandro,CA,94532 
415,899-3400,12.89,1.98,14.87 
02/16/82,5,Ms ,Annetie L ,Robinson,1322 Blue Ridge Dr.,San Diego,CA,98443 
714,399-5899, 12.34,5.99,18 33 
02/25/82,8,Mr.,Gerald R_,Franklin,87 Willow Ave.,Gunnison,CO,81539 
303,390-4879,33,67,33.67,67.34 
02/03/82,1,Mr Jetlrey M.Jefferies,622 Virginia Hills,Denver,CO,80288. 
303,372-9999,23,45,55.44,78.89 
02/17/82,6,Mr.,Roland M ,Robinson,1745 Navajoe Rd.,San Francisco,CA,94720 
415,372-6590,234 77,89.45,324.22 
02/13/82,4,Mr.,James Peter,Livingston,3354 Main Street,San Ratael,CA,94902 
415,893-5599,454 33,15.00,469.33 
02/15/82,3,Ms.,Ester,Williams,724 West Broadway,Pueblo,CO,81293 
303,228-6648,458.99,230.00,688.99 
02/06/82,2,Dr .Carl C..Chester,1808 Oak Hill Dr.,Alhambra,CA,94553 
213,372-8899,287.99,645.78,933.77 


In this example, eight data records are each broken 
into two lines, but on your screen, horizontal 
scrolling permits eight records in eight lines. 
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NOTE: If you use WordStar in non-document mode i) 
to create your datafile, MicroPro recommends that 

you use only commas to separate fields and only 

carriage returns to separate records. Otherwise, you 

will not be able to use the datafile with other 

programs in the MicroPro family. 


Here is the command file you create to extract an 
address list datafile from INVOICE.DTA. The first 
four dot commands are required, and the file must 
end with a hard carriage return. 


.MTO 

M80 

POO 

.PF OFF 

.DF INVOICE.DTA 

RV Date,N, Title, First, Last, Street,City,State Zip,Area 
.RV Phone,PrevBal,AmiChgd,BalDue 

&Title&, &First& &Last&, &Street&, &City&, &State&,&Zip& 


To produce the new datafile MAILINV.DTA: 


¢ Run MailMerge on the command file. 
¢ Choose disk output option. 


MAILINV.DTA 


Ms .tydia Esther, Womack,8993 Cherry Ave ,San Leandro,CA.94532 
Ms. Annette L Robinson, 1322 Blue Ridge Or.,San Diego,CA,98443 
Mr ,Gerald A.,Franklin.87 Willow Ave.,Gunnison,CO,81539 
Mr.Jetirey M.Jefteries,622 Virginia Hills. Denver,CO,80288 
Mr.,Roiand M.,Robinson,1745 Navajoe Rd. San Francisco,CA,94720 
Mr James Peter,Livingston,3354 Main Street,San Rafacl,CA,94902 
Ms..Ester,Williams,724 West Broadway,Pueblo.CO.81293 

Dr..Carl C.,Chester,1808 Oak Hill Dr. ,Alhambra,CA,94553 


Use the new datafile for all your mailing tasks. Some 
of these tasks will be described in the applications 
which follow. 


2. Printing Mailing Labels in Three Columns 


MailMerge can print your name and address datafile 
in tabular form suitable for mailing labels. In the 
WordStar Training Guide you printed single column 
labels. This example shows how to print the datafile 
MAILINV.DTA in three columns to correspond to 
three columns of labels. 
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MAILINV.DTA 


Ms.,Lydia Esther,Womack.8993 Cherry Ave..San Leandro,CA,94532 
Ms.,Annette L .Robinson,1322 Blue Aidge Or.,San Diego,CA,98443 
Mr.,Gerald R ,Franklin,87 Willow Ave.,Gunnison,CO,81539 

Mr Jeftrey M.Jefferies,622 Virginia Hills,Denver,CO,80288 
Mr.,Rotand M.,Robinson,1745 Navajoe Rd .San Francisco,CA,94720 
Mr.,James Peter,Livingston,3354 Main Street,San Rafael,CA,94902 
Ms.,Esior,Wiliams,724 West Broadway,Pueblo,CO,81293 

Dr.,Carl C.,Chester, 1808 Oak Hill Dr. ,Alnambra,CA,94553 


Carefully prepare the master document to look like 
the following illustration. The document must have 
three columns with tabs and margins set precisely to 
match the mailing labels on the printer. As you 

prepare this example remember to do the following: 


¢ Set TABs to correspond to label sizes (26 and 51 
in this example). 


Be sure to use the TAB key or “I to move the 
cursor. Do not use the SPACE bar. 


© Use three .RV commands (for three columns) and 
put the numbers 1, 2, and 3 after each generic 
name. 


NOTE: A hyphen (-) flag appears in the right 
hand column of a line containing “~P RETURN. 


e Press RETURN after the generic name in the third 
column. 


oO 


Lenco enn nnnnen eee Loew nee ree neene cee ee Pannen nen enn ee eee cee eee ne ene a 
OP 


.DF MAILINV. OTA 

AV Titlet, Fizstt, Lasi1, Streett, City1, State1, Zipt 
-RV Title2, First2. Last2, Street2, City2, State2, Zip2 
RV Title3, First3, Last3, Street3, Cily3, State3, Zip3 


&Title1& &Firstt& &Lasti& “P RETURN 
&Tile2& &Firsi2& &Last2& “P RETURN 
GTitle3& &First3& &Lasi3& RETURN 


&Streeti& “P RETURN 
&Street2& “P RETURN 
&Streei3& RETURN 


&Cily1& “P RETURN 
&City2& “P RETURN 
&City3&8 RETURN 


&State1& &Zip1& “P RETURN 
&State2& &Zip2& “P RETURN 
&Siate3& &Zip3& RETURN 


NOTE: Although “P RETURN and RETURN have 
been printed in the illustration to show exactly how 
to set up the three columns, they do not actually ap- 
pear on the screen. 


When the master document is ready: 
e Print the master document with MailMerge. 


© Ignore the ‘‘null data’’ warning message that 
appears on the screen when you print. 
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MailMerge prints the name and address file in three ae) 
columns as shown in the following example: 


Ms, Lydia Esther Womack Ms. Annette L. Robinson Mr. Gerald R. F 
8993 Cherry Ave. 1322 Blue Ridge Dr. 87 Willow Ave 
San Leandro San Diego Gunnison 
CA 94532 CA 98443 CO 81539 
Mr. Jeffrey M. Jefferies Mr. Roland M. Robinson Mr. James Peter Livingston 
622 Virginia Hills 1745 Navajoe Rd. 3354 Nain Street 

Denver l San Francisco San Rafael 

cO 80288 CA 94720 CA 94902 
Ms. Ester Williams Dr, Carl ©. Chester 
724 West Broadway 1808 Oak Hill Or. 
Pueblo Alhambra 
CO 81293 CA 94553 


Use MailMerge to print other tabular data such as 
figures and statistics or even designs. 


3. Using File Inserts to Put Paragraphs in a Letter 


Suppose you want to send a variation on a form 
letter to customers in different regions. You can 
insert a special paragraph in each letter with file 
inserts. 


For this example, the datafile, MAILINV.DTA has 
been altered slightly. Some cities and states have been 
changed. 
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MAILINV.DTA 


Ms, Lydia Esther. Womack,6993 Cherry Ave San Leandro,CA,94532 
Ms ,Annette L Robinson.1322 Biue Ridge Dr. ,Dailas, TX 75277 

Mr ,Roland M Robinson,1745 Navajoe Rd .San Francsco,CA,94720 
Mr James Peter,Livingston,3354 Main Street,San Rafael.CA,94902 
Ms. Ester Wolliams,724 Wes! Broadway Puebdlo,CO 81293 

Or. .Carl C.,Chester,1808 Oak Hill Dr Buffalo NY 14251 

Mr Gerald R .Franklin.87 Willow Ave.,Gunn-son,CO,81539 

Mr Jeffrey M Jetfenes,622 Virginia Hills. Denver,CO,80288 


Four separate document files are created, using the 
state abbreviations as file names, i.e., CA, CO, TX, 
NY. A paragraph, in this case, the address of a 
regional dealer, is put in each file. A .FI (file insert) 
with &STATE& as the generic name is placed in the 
master document where the dealer address is to go: 


FL &STATES& 


That’s it. 


When MailMerge is run, the state from the datafile 
record is inserted in place of the generic name. Then, 
as it is a .FI command, the file with the 
corresponding state name is inserted into that place. 


Here are the separate files created: a) 


(FILE CA) 

Cosmic Creations 
1980 Main St. 

San Rafael, CA 94903 


(FILE CO) 
Electronic Ecstasy 
3218 Collins Ave. 
Denver, CO 80202 


(FILE NY) 
Global Gizmos 

36477 N.W. First St. 
New York, NY 10168 


(FILE TX) 

Futuristic Funthings 
Five-fifty $5th St. 
Dallas, TX 75240 


Here is the master document: 


OP 
.DF MAILINV.DTA 
»RV TITLE, FIRST,LAST,STREET,CiTY,STATE,ZIP 


&TITLE& &FIRST& &LASTS 
&STREET& 

&CITY&, &STATES &ZIP& 
Dear &TITLE& &LAST&, 


Thank you for your interest in Gatactica products. The enclosed flyer should 
introduce you to the advantages that Galactica toys offer 


If you have any questions you may contact the dealer in your area: 
Ft &STATE& 


ff 1 can be of any further service to you, please do not hesitate to cail. 


Sincerely, 


Jay Salesman 
Galactica 
-PA 


#) Here is one result: 


Dr. Carl C. Chester 
1808 Oak Hill Dr. 
Buffalo, NY 14251 


Dear Dr. Chester, 


Thank you for your interest in Galactica products. The enclosed flyer should 
Introduce you to the advantages that Galactica toys offer. 


If you have any questions you may contact the deaier In your area: 
Global Gizmos 


36477 N.W. First St. 
New York, NY 10168 


tf | can be of any further service to you, please do not hesitate to call. 


Sincerely, 


Jay Salesman 
Galactica 
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4. Changing Legal Documents into Master 
Documents 


Many forms produced in legal offices are identical 
except for names and dates. These legal documents 
can easily be changed into master documents to be 
used with MailMerge. 


This form, a ‘‘Stipulation and Order for Transfer,’’ 
has been made into a master document by 
substituting generic names enclosed by ampersands 
throughout the form wherever a change would occur. 
As you can see, the text remains the same; only 
names and numbers are changed. 


MailMerge dot commands are placed at the top of 
the form. In this case .RV commands (Read 
Variables) have been used. The example supplies a 
datafile, LEGAL.DTA, with the information needed 
to complete the form. A .SV command (Set Variable) 
has been used to set the date for each unique 
document. 


A completed form with information from the first 
record in LEGAL.DTA follows the master document. 


The following datafile, LEGAL.DTA, is used with 
the master document file, LEGAL.FRM. These data 
match the order of the generic names in the .RV 
(read variable) line of the master document. 


NOTE: On your screen, ‘‘Birney, Barnes, Billings’’ 
would appear on the same line as each data record, 
not on a second line, as in this example. 


LEGAL.DTA 


Owen Marshall,9988765,John Smith,James Jones,William Foster,Ralph Morris, 
“Bimey, Barnes, Billings” 


Della Street,4532679, Barrymore, Taylor,Reynolds,Fisher, 
“Birney, Barnes, Billings” 

Perry Mason,8765890,Cunningham,Webber,Fonzerelli,Ralph, 
“Birney, Barnes, Billings” 


oO 


* 


OP 
DF LEGAL OTA 
RV ATTORNEY NUMBER, PLAINTIFF. DEFENDANT,CROSSCOM,CROSSDEF,.LAWFIRM. 


SV GATE JUNE 30 1982 


Jones Srmth and Mason 
&ATTORNEY& 

33 Market Street 

Suite 35 

San Francisco, CA 94801 
(415) 555-3412 


IN THE MUNICIPAL COURT 
San Francicca, Calforna 


&PLAINTIFFS, 

Plaintitt, No 8NUMBER& 
STIPULATION AND ORDER FOR 
TRANSFER OF ACTION TO SUPERIOR 


&DEFENDANT& couat 
Detengant 


vs 


&CROSSCOME, 
Cross-complainant 


vs 


&CROSSDEF& 
Cross-defendant 


IT1S HEREBY STIPULATED by and between counsel for the parties in the above-entilled 
action that the action shall be transterred to the Superior Court of California, San Francisca, 
because the cross-complainant has raised the amount involved beyond the jurisdiction of this 


court 


Dated. &DATE& 


Attorney tor Plaintif 
&LAWFIRME& 


By 


Attorneys for Defendants 
and Cross-compiainant 


ORDER 
\t is so ordered. 


Datea: 


Judge of the Municipal Court 
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Jones, Smith and Mason 
Owen Marshall 

33 Market Street 

Suite 35 

San Francisco, CA 94801 
(415) 555-3412 


IN THE MUNICIPAL COURT 
San Francisco, California 


John Smith, 
Plaintiff, No, 9988765 
vs. STIPULATION AND ORDER FOR 
TRANSFER OF ACTION TO SUPERIOR 
James Jones, COURT 
Defendant, 


William Foster, 
Cross-complainant, 


vs. 


Ralph Morris, 
Cross-defendants. 


IT IS HEREBY STIPULATED by and between counsel for the parties in the above- 
entitled action that the action shall be transferred to the Superlor Court of California, San 
Francisco, because the cross-complainant has raised the amount involved beyond the 
Jurisdiction of this court. 


Dated: June 30, 1982 


Attorney for Plaintiff 
Birney, Barnes, Billings 


By 


Attorneys for Defendants 
and Cross-complainant 


ORDER 
It Is so ordered. 


Dated: 


Judge of the Municipal Court 


5. Completing Legal Forms with Operator Input: 
An Affidavit 


An ‘‘Affidavit’’ has been made into a master 
document with generic names substituting for names, 
numbers, etc. In this example, .AV commands (Ask 
Variable) are used. As these questions appear on the 
screen one at a time when MailMerge is run, the 
operator types information in response. 


Notice that the generic names are boldfaced on the 
master document by using the WordStar boldfacing 
command - “PB - when the form is created. The 
variable data which are substituted for the generic 
names are in turn boldfaced, as you can see on the 
completed form which follows: 


AFFIDAVIT 
POWER OF ATTORNEY OF AUTHORIZATION OF AGENT 


Av “Date of issue ?” Date 

AV "Which State?” State 

.AV ‘Which County?” County 

cs 

AV “Trademark” Trademark 

.AV “Registrant or authorized person?” Registrant 

AV “Registration Number?" Number 

AV “Type of Commerce? Interstate or Foreign” Commerce 


Mark &Trademark& 
Reg. No. &Number& 
Date of issue &Date& 
To: &Registrant& 


State of &State& 
County of &County& 


&Registrant& being sworn, states that &Registrant& owns Registration 
No. &Number&, as shown by records in the Patent Office: that said registration 
is now in force; that the mark shown therein is in use in &Commerce& commerce 
on each of the following goods recited in the registration &Number&: and that 
the benefits of the acl of July 5, 1946, are hereby claimed for said registration. 


(Signature and Title) 
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C-14 


AFFIDAVIT 
POWER OF ATTORNEY OF AUTHORIZATION OF AGENT 


Mark DATA TOGGLES 

Reg. No. 2,345,678 

Date of issue August 31, 1982 
To: Jamison Doe 


State of California 
County of Los Angeles 


Jamison Doe being sworn, states that Jamison Doe owns Registration 
No. 2,345,678, as shown by records in the Patent Office; that said registration 
is now in force, that the mark shown therein is in use in Interstate commerce 
on each of the following goods recited in the registration 2,345,678, and that the 
benefits of the act of July 5, 1946, are hereby claimed for said registration. 


(Signature and Title) 


ad 
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Appendix D 
Quick Guides to Using MailMerge 


To produce a series of personalized form letters, a 
list of mailing addresses is merged with a master 
document for a form letter. 


-cs 
1aV"Plaase enter todays date” 
‘fl formitr 


cd 


TO CREATE 
YOUR MAILING 
LIST 


Quick Guide I: Producing A Datafile 
(Mailing List) 

In creating a mailing list, or any datafile, you must 
follow these guidelines (or use DataStar, which will 


automiatically set up your file this way): 


1, Enter data using WordStar in NON-DOCUMENT 
mode. 


2. Begin each record in COLUMN 1. 


3. Separate categories of information (fields) with 
COMMAS. 


4. Follow every field with a comma 
EVEN IF THERE IS NO DATA FOR A FIELD. 


5. If a field entry is to contain a comma, frame the 
entire field in QUOTES. 


6. Follow the last field in each record with a 
CARRIAGE RETURN, 


7. Enter every record with the same number of fields, 
in the same order. 


These guidelines are illustrated in the steps below: 
STEP |. From the WordStar Opening Menu: 
DYRE SN 


SEE: 


TYPE: mailing.dta RETURN 


STEP 2. Enter your mailing list, following the 
y 
guidelines listed above. 


B:CUSTOMER DTA 


Ms.,Dee Skies, Astrologer,77 Sunsat Strip,"'Hollywood, CA",90025,WordStar << RETURN 
Mr Flash Gordon, 99 Nova Avenue, ‘Dallas, TX”.75231,DataStar < RETURN 
Mr Patrick Pollux, 33 Galaxy Circle,""Century City, CA”.90068,DataStar = < RETURN 
Mr Sky King.Rancher, ,“ Missoula, MT'",59802, Word! < RETURN 
Ms.,Polly Polaris.Space Caseworker,664 Etoile Court, "Jacksonville, FL".331 + RETURN 


STEP 3. Save your file: After the last RETURN, 


TYPE: “KD 


fd 


TO CREATE 
YOUR FORM 
LETTER 


Quick Guide 2: Producing A Master 
Document 


The form letter shown in the example below uses the 
mailing list datafile created in QUICK GUIDE 1. 


The basic guidelines which apply to master 
documents are: 


1. Enter the .DF COMMAND BEFORE THE .RV 
COMMAND 


is) 


. Identify all generic names, using .DF, .AV and 
-SV commands, before they are placed in the text 
and SURROUNDED BY AMPERSANDS. 


3. End the last line with a CARRIAGE RETURN. 
When the master document is a form letter, end 
the last line with a NEW PAGE COMMAND 
(PA) followed by a carriage return. 

These guidelines are illustrated in the steps below: 


STEP |. From the WordStar Opening Menu: 


TYPE: D 


SEE: 


TYPE: formltr RETURN 


STEP 2. Beginning in column 1, enter the form 
letter exactly as shown below. 


op RETURN 
df customer.dta RETURN 

tv m,name,title,street,locale,zip, product RETURN 
-sv DATE November 13, 1983 RETURN 

Adate& RETURN 

RETURN 

&m& &name& RETURN 

Btitle/O& RETURN 

asiroetviO& RETURN 

&locale& &zip& RETURN 

RETURN 


Dear &m& &namea, RETURN 
RETURN 

(type the body of your letter and the closing) 
pa RETURN 


STEP 3. Save your file: After the last RETURN, 


TYPE: “KD 


rd 


TO PRI 
YOUR LETTERS 


Quick Guide 3: Printing Through MailMerge 
(Form Letter Series) 

The example below gives instructions for printing the 
form letter produced in QUICK GUIDE 2, with the 
mailing list created in QUICK GUIDE 1. 


STEP 1. From the WordStar Opening Menu: 


TYPE: M 


TYPE: formltr RETURN 


STEP 2. Answer the following prompts as shown: 


For default press RETURN for each question 
Disk file output (Y/N) RETURN 
Start at page number? RETURN 
Stop atter page number? RETURN 
Number of copies? RETURN 
Use form feeds (Y/N). RETURN 
Suppress page formatting (Y/N) RETURN 
Pause for paper change between pages (Y/N) Y RETURN 

Ready printer, press RETURN: RETURN 


STEP 3. MailMerge will pause after each letter, and 
wait for you to prepare your printer with 


the next sheet of letterhead paper. When 
the printer is ready, respond: 


oa 


CREATE YOUR 
COMMAND FILE 


Quick Guide 4. Creating A Command File 
(For Form Letter) 


The form letter produced in QUICK GUIDE 2 used 
the .SV command to specify the DATE within the 
FORMLITR file itself. In this example, a command 
file is created which includes an .AV command to 
ask for the date at the start of the print run. 


A “command’’ file contains no text (or very little 
text); each line is a MailMerge DOT COMMAND. 


STEP 1. Create your datafile(s) and master docu- 
ment(s) as shown in QUICK GUIDES 1 
and 2, but omit the line in the form 
letter which begins with the command: 


aS 


STEP 2. From the WordStar Opening Menu: 
TYPE: N 
SBEX 


Name of file to edit? 


TYPE: formltr.emd RETURN 
STEP 3. Beginning in column 1, enter a list of 
commands as shown: 


cs 


.av “'Please enter today's date:", DATE 
fi formitr 


STEP 4. Save your file: 
After the lat RETURN, TYPE “KD 
STEP 5. From the WordStar Opening Menu: 
TYPE: M 
SEE: 


Name of file to MailMerge? 


TYPE: formltr.emd RETURN 
Answer the prompts as shown in QUICK 
GUIDE 3. 

STEP 6. MailMerge will clear the screen and 
display this prompt: 


Please enter today's date 


Respond by typing the date and pressing 
RETURN. 

STEP 7. MailMerge will pause after each letter, and 
wait for you to prepare your printer with 
the next sheet of letterhead paper. 
Respond as shown in QUICK GUIDE 3. 
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